3 * Copyright (C) 2007 EDIT
4 * European Distributed Institute of Taxonomy
5 * http://www.e-taxonomy.eu
7 * The contents of this file are subject to the Mozilla Public License Version 1.1
8 * See LICENSE.TXT at the top of this package for the full license terms.
11 package eu
.etaxonomy
.cdm
.remote
.controller
;
13 import java
.io
.IOException
;
14 import java
.util
.Arrays
;
15 import java
.util
.List
;
16 import java
.util
.UUID
;
18 import javax
.servlet
.http
.HttpServletRequest
;
19 import javax
.servlet
.http
.HttpServletResponse
;
21 import org
.springframework
.beans
.factory
.annotation
.Autowired
;
22 import org
.springframework
.stereotype
.Controller
;
23 import org
.springframework
.web
.bind
.annotation
.PathVariable
;
24 import org
.springframework
.web
.bind
.annotation
.RequestMapping
;
25 import org
.springframework
.web
.bind
.annotation
.RequestMethod
;
26 import org
.springframework
.web
.servlet
.ModelAndView
;
28 import com
.wordnik
.swagger
.annotations
.Api
;
30 import eu
.etaxonomy
.cdm
.api
.service
.IDescriptionService
;
31 import eu
.etaxonomy
.cdm
.api
.service
.INameService
;
32 import eu
.etaxonomy
.cdm
.api
.service
.pager
.Pager
;
33 import eu
.etaxonomy
.cdm
.database
.UpdatableRoutingDataSource
;
34 import eu
.etaxonomy
.cdm
.model
.description
.TaxonNameDescription
;
35 import eu
.etaxonomy
.cdm
.model
.name
.TaxonNameBase
;
36 import eu
.etaxonomy
.cdm
.model
.name
.TypeDesignationBase
;
39 * The NamePortalController class is a Spring MVC Controller.
41 * The syntax of the mapped service URIs contains the the {datasource-name} path element.
42 * The available {datasource-name}s are defined in a configuration file which
43 * is loaded by the {@link UpdatableRoutingDataSource}. If the
44 * UpdatableRoutingDataSource is not being used in the actual application
45 * context any arbitrary {datasource-name} may be used.
47 * Methods mapped at type level, inherited from super classes ({@link BaseController}):
49 * URI: <b>/{datasource-name}/portal/name/{name-uuid}</b>
51 * Get the {@link TaxonNameBase} instance identified by the <code>{name-uuid}</code>.
52 * The returned TaxonNameBase is initialized by
53 * the following strategy: -- NONE --
56 * @author a.kohlbecker
62 @RequestMapping(value
= {"/portal/name/{uuid}"})
63 public class NamePortalController
extends BaseController
<TaxonNameBase
, INameService
>
66 private static final List
<String
> TYPEDESIGNATION_INIT_STRATEGY
= Arrays
.asList(new String
[]{
69 "typeStatus.representations",
70 "typifiedNames.nomenclaturalReference.authorship",
71 "citation.authorship.$",
76 private static final List
<String
> NAMEDESCRIPTION_INIT_STRATEGY
= Arrays
.asList(new String
[]{
80 "elements.multilanguageText",
85 // public NamePortalController(){
87 // setInitializationStrategy(Arrays.asList(new String[]{"$"})); //TODO required???
91 * @see eu.etaxonomy.cdm.remote.controller.GenericController#setService(eu.etaxonomy.cdm.api.service.IService)
95 public void setService(INameService service
) {
96 this.service
= service
;
100 private IDescriptionService descriptionService
;
103 * Get the list of {@link TypeDesignationBase}s of the
104 * {@link TaxonNameBase} instance identified by the <code>{name-uuid}</code>.
106 * URI: <b>/{datasource-name}/portal/name/{name-uuid}/typeDesignations</b>
110 * @return a List of {@link TypeDesignationBase} entities which are initialized
111 * using the following initialization strategy:
112 * {@link #TYPEDESIGNATION_INIT_STRATEGY}
113 * @throws IOException
115 @SuppressWarnings("unchecked")
117 value
= {"typeDesignations"},
118 method
= RequestMethod
.GET
)
119 public List
<TypeDesignationBase
> doGetTypeDesignations(@PathVariable("uuid") UUID uuid
,
120 HttpServletRequest request
, HttpServletResponse response
)throws IOException
{
121 ModelAndView mv
= new ModelAndView();
122 TaxonNameBase tnb
= getCdmBaseInstance(uuid
, response
, (List
<String
>)null);
123 Pager
<TypeDesignationBase
> p
= service
.getTypeDesignations(tnb
, null, null, null, TYPEDESIGNATION_INIT_STRATEGY
);
124 return p
.getRecords();
128 * Get the list of {@link TaxonNameDescription}s of the Name associated with the
129 * {@link TaxonNameBase} instance identified by the <code>{name-uuid}</code>.
131 * URI: <b>/{datasource-name}/portal/name/{name-uuid}/descriptions</b>
135 * @return a List of {@link TaxonNameDescription} entities which are initialized
136 * using the following initialization strategy:
137 * {@link #NAMEDESCRIPTION_INIT_STRATEGY}
138 * @throws IOException
141 value
= {"taxonNameDescriptions"},
142 method
= RequestMethod
.GET
)
143 public List
<TaxonNameDescription
> doGetNameDescriptions(@PathVariable("uuid") UUID uuid
,
144 HttpServletRequest request
, HttpServletResponse response
)throws IOException
{
145 logger
.info("doGetNameDescriptions()" + request
.getRequestURI());
146 TaxonNameBase tnb
= service
.load(uuid
, null);
147 Pager
<TaxonNameDescription
> p
= descriptionService
.getTaxonNameDescriptions(tnb
, null, null, NAMEDESCRIPTION_INIT_STRATEGY
);
148 return p
.getRecords();