WiewsController.java

/*
 * Copyright 2025 Global Crop Diversity Trust
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *   http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package org.genesys.server.api.v2.impl;

import io.swagger.annotations.Api;
import org.genesys.server.api.ApiBaseController;
import org.genesys.server.api.v2.facade.InstituteApiService;
import org.genesys.server.api.v2.model.impl.VocabularyTermDTO;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.http.MediaType;
import org.springframework.security.access.prepost.PreAuthorize;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;

import java.io.IOException;
import java.util.Collections;
import java.util.List;
import java.util.Map;
import java.util.Set;

@RestController("wiewsApi2")
@RequestMapping(WiewsController.CONTROLLER_URL)
@PreAuthorize("isAuthenticated()")
@Api(tags = { "vocabulary" })
public class WiewsController extends ApiBaseController {

	/** The Constant CONTROLLER_URL. */
	public static final String CONTROLLER_URL = ApiBaseController.APIv2_BASE + "/vocabulary" + "/wiews"; // TODO VocabularyController APIv2 URL

	@Autowired
	private InstituteApiService instituteService;

	/**
	 * Gets the.
	 *
	 * @param code the code
	 * @return the vocabulary term
	 */
	@GetMapping(value = "/{code}", produces = MediaType.APPLICATION_JSON_VALUE)
	public VocabularyTermDTO getWiewsTerm(@PathVariable("code") final String code) {
		return instituteService.getInstituteTerm(code);
	}

	/**
	 * Autocomplete.
	 *
	 * @param text the text
	 * @return the list
	 * @throws IOException Signals that an I/O exception has occurred.
	 */
	@GetMapping(value = "/autocomplete", produces = MediaType.APPLICATION_JSON_VALUE)
	public List<VocabularyTermDTO> autocompleteWiewsTerm(@RequestParam("term") final String text) {
		if (text.length() < 3) {
			return Collections.emptyList();
		}

		return instituteService.autocompleteTerm(text);
	}

	/**
	 * Decode codes
	 * @return the Map of wiews codes -> institute names
	 */
	@PostMapping(value = "/decode", produces = MediaType.APPLICATION_JSON_VALUE)
	public Map<String, String> decodeWiewsCodes(@RequestBody(required = false) Set<String> codes) {
		return instituteService.decodeWiewsCodes(codes);
	}
}