source: main/trunk/ibisph-view/src/main/webapp/WEB-INF/config/spring/SiteSpecific.xml @ 25613

Last change on this file since 25613 was 25613, checked in by GarthBraithwaite_STG, 14 months ago

view - put back the IP request json controllers until .js request is ready.

File size: 18.7 KB
1<?xml version="1.0" encoding="UTF-8"?>
3<beans default-lazy-init="false" default-autowire="no"
4        xmlns=""
5        xmlns:xsi=""
6        xsi:schemaLocation=""
8        <!--
9                This file has 3 functions:
10                1) Specify/load the application's spring bean definition files.
11                2) Provide the dispatcher servlet URL to controller mappings.
12                3) Override any spring bean definitions as per adopter's specific needs.
13                   Note that the properties file should be configured in this file IF
14                   they are needed/used.
15        -->
17        <!--
19                Specifies the Spring application context definition files which are
20                responsible for creating the application's objects.  To keep these
21                definitions more maintainable the bean definitions are stored in their
22                own file (beans are grouped by functionality).  There are two available
23                mechanisms to load these files:
24                1) web.xml - can specify a list of bean files to load.  Note that this
25                   mechanism is the same - the difference is that it only specifies
26                   this file.
27                2) This file can be used with the spring bean "import" mechanism.  This
28                   mechanism works the same way the XSLT import works with the last
29                   import taking precedence (which for imports is typically not a problem
30                   as they should be independent).  However, the 2nd part of this file
31                   allows for an adopter to override any bean definition OR the adopter
32                   can put all their overrides in a separate file and import that file
33                   last etc.
35                IMPORTANT IMPORT NOTES:
36                Some beans have dependencies on other beans so inclusion of 1 file
37                may result in the need for additional file(s).  The request dispatcher
38                URL to controller mappings require that all controller objects be
39                defined.  In either case if a bean references another bean and that
40                bean/object is not defined the application will not start (you will
41                see an error in the output log about bean definition missing/not found).
43                ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
44                !!! IMPORTANT - SECURITY CONFIGURATION !!!
45                ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
46                When making security config changes consult ALL the notes and comments
47                within the security files and the admin webapp's security_notes.txt
48                file.  At some point someone will document this but for now these
49                comments should provide enough help for a java web developer to be
50                able to connect the dots.
52                If doing secure URLs at least two security definitions need to be
53                specified: the general (security.xml) and the specific security
54                configuration (security-xxx.xml) which supplements.
55        -->
56        <import resource="common.xml"/>
57        <import resource="filter.xml"/>
59        <import resource="security.xml"/>
60        <import resource="security-pre_authenticated.xml"/>
61        <import resource="security-db_authentication.xml"/>
62        <import resource="security-xml_authentication.xml"/>
64        <import resource="security-no_authentication.xml"/>
65        <import resource="https.xml"/>
68        <import resource="indicator.xml"/>
69        <import resource="query.xml"/>
70        <import resource="query-definition.xml"/>
71        <import resource="publication.xml"/>
72        <import resource="community.xml"/>
73        <import resource="topic.xml"/>
74        <import resource="secure.xml"/>
75        <import resource="user.xml"/>
77        <import resource="view.xml"/>
80        <bean id="siteSpecificDispatcherServletURLMap" class="java.util.HashMap">
81                <description>
82                        Defines the mapping of URL patterns to the appropriate IBIS-PH
83                        Controller.  The definitions are defined here and referenced in the
84                        dispacther_servlet.xml file because the ds.xml load occurs after
85                        this bean file is processed which would require an adopter to have
86                        to maintain and track the d_s.xml file.  Keeping them in this file
87                        also is the right place as this file contains the bean imports.
89                        IMPORTANT IMPORT NOTE:
90                        The request URLs to controller mapping MUST match the specified
91                        controller.  Otherwise the application will not start and the log
92                        will show an undefined bean error in the log.  Make sure that the
93                        imports match the needed controller.
95                        For example if secure query is wanted then the secure.xml spring bean
96                        controller definition file would need to imported.  The "secure" type
97                        requests would then need to be mapped to the respective controller.
99                        Note the first part of the controller name corresponds with the
100                        Spring bean definition file that includes that controller's
101                        definition (this is the case with all IBIS-PH Spring bean defs -
102                        they all have a prefix that is associated with the bean XML file.
104                        ORDERING: The best practice is to be order most specific to least.
105                </description>
106                <constructor-arg>
107                        <map>
108                                <!-- D E F A U L T   H T M L   C O N T E N T -->
109                                <entry key="/**/*.html" value-ref="viewHTMLContentConventionController"/>
111                                <!-- Note these will only get hit for defined web.xml blanket
112                                        mappings so requests like indicator/ or query/
113                                        but NOT about/ or topic/ as these have no web.xml mapping.
114                                -->
115                                <entry key="/*/"                value-ref="viewHTMLContentConventionController"/>
117                                <!-- T O P I C -->
118                                <entry key="/topic/**"                                          value-ref="topicHTMLContentConventionController"/>
120                                <!-- C O M M U N I T Y -->
121                                <entry key="/community/indicators/**"                   value-ref="communityIndicatorsController"/>
122<entry key="/community/oindicators/**"                  value-ref="communityIndicatorsOldController"/>
123<entry key="/community/facts/**"                                value-ref="communityFactsController"/>
125                                <!-- I N D I C A T O R  -->
126                                <entry key="/indicator/index/Alphabetical.html" value-ref="indicatorAlphabeticalIndexController"/>
127                                <entry key="/indicator/index/DataSource.html"   value-ref="indicatorDataSourceIndexController"/>
128                                <entry key="/indicator/index/Organization.html" value-ref="indicatorOrgUnitIndexController"/>
129                                <entry key="/indicator/index/Set.html"                  value-ref="indicatorIndicatorSetIndexController"/>
130                                <entry key="/indicator/index/Table.html"                value-ref="indicatorTableIndexController"/>
131                                <entry key="/indicator/index/Demographic.html"  value-ref="indicatorDemographicIndexController"/>
133                                <entry key="/indicator/summary/*.html"                  value-ref="indicatorSummaryViewController"/>
134                                <entry key="/indicator/view/*.html"                             value-ref="indicatorViewController"/>
135                                <entry key="/indicator/complete/*.html"                 value-ref="indicatorCompleteViewController"/>
136                                <entry key="/indicator/facts/*.html"                    value-ref="indicatorImportantFactsController"/>
137                                <entry key="/indicator/services/*.html"                 value-ref="indicatorServicesController"/>
138                                <entry key="/indicator/related/*/*.html"                value-ref="indicatorRelatedIndicatorsController"/>
139                                <entry key="/indicator/resources/*.html"                value-ref="indicatorResourcesController"/>
141                                <entry key="/indicator/contentblocks/*.html"    value-ref="indicatorContentBlocksController"/>
142<entry key="/indicator/view/*.json"                             value-ref="indicatorViewJSONController"/>
143<entry key="/indicator/*.json"                                  value-ref="indicatorJSONController"/>
144<entry key="/indicator/content/*.js"                    value-ref="indicatorContentJavaScriptController"/>
146                                <entry key="/indicator/preview/*.html"                  value-ref="indicatorPreviewController"/>
147                                <entry key="/indicator/view/preview/*.html"             value-ref="indicatorViewPreviewController"/>
149                                <!-- Q U E R Y  -->
150                                <entry key="/query/selection/**"                                value-ref="querySelectionController"/>
151                                <entry key="/query/configuration/**"                    value-ref="queryConfigurationController"/>
152                                <entry key="/query/builder/**"                                  value-ref="queryBuilderController"/>
153                                <entry key="/query/submit/**/*.html"                    value-ref="querySubmitController"/>
154                                <entry key="/query/result/**/*.html"                    value-ref="queryResultController"/>
155                                <entry key="/query/result/**/*.xls"                             value-ref="queryResultController"/>     <!-- put here so can plug in Excel specifici controller in the future. -->
156                                <entry key="/query/result/**/*.xml"                             value-ref="queryIBISQResultController"/>       
158                                <entry key="/query/contentblocks/**"                    value-ref="queryResultContentBlocksController"/>
161                                <!-- Q U E R Y   D E F I N I T I O N -->
162                                <entry key="/query/definition/list/*"                   value-ref="queryDefinitionListController"/>
163                                <entry key="/query/definition/index/*"                  value-ref="queryDefinitionIndexController"/>
164                                <entry key="/query/definition/detail/*/*"               value-ref="queryDefinitionDetailController"/>
166                                <entry key="/query/definition/result/*/*"               value-ref="queryDefinitionResultController"/>
167                                <entry key="/query/definition/builder/*/*"              value-ref="queryDefinitionBuilderController"/>
168                                <entry key="/query/definition/contentblocks/**" value-ref="queryDefinitionResultContentBlocksController"/>
170                                <entry key="/query/definition/save"                             value-ref="queryDefinitionSaveController"/>
171                                <entry key="/query/definition/delete/*"                 value-ref="queryDefinitionDeleteController"/>
172                                <entry key="/query/definition/set_apply"                value-ref="queryModuleToApplyQueryDefinitionController"/>
174                                <!-- IMPORTANT NOTICE: If there are sensitive datasets that are
175                                        exposed via a Query Module and the IBISPH-VIEW to IBIS-Q
176                                        then this proxy should either a) be removed from this file
177                                        or b) have the proxy's application URL point to an invalid
178                                        URL or c) protect the request via spring security.  Also
179                                        make sure that all of those sensitive dataset URL requests
180                                        are protected and that the backend IBIS-Q CGI application
181                                        is not made available except to the ibisph-view webapp.
182                                -->
183                                <entry key="/query/proxy*"                      value-ref="queryQueryApplicationProxyController"/>
186                                <!-- S E C U R E  -->
187                                <entry key="/secure"                                                    value-ref="secureSelectionController"/>
188                                <entry key="/secure/test.jsp"                                   value-ref="secureTestController"/>
189                                <entry key="/secure/selection/*.html"                   value-ref="secureSelectionController"/>
190                                <entry key="/secure/query/selection/**"                 value-ref="secureQuerySelectionController"/>
191                                <entry key="/secure/query/builder/**"                   value-ref="secureQueryBuilderController"/>
192                                <entry key="/secure/query/submit/**/*.html"             value-ref="secureQuerySubmitController"/>
193                                <entry key="/secure/query/result/**/*.html"             value-ref="secureQueryResultController"/>
194                                <entry key="/secure/query/result/**/*.xls"              value-ref="secureQueryResultController"/>
195                                <entry key="/secure/query/result/**/*.xml"              value-ref="secureQueryIBISQResultController"/> 
196                                <entry key="/secure/query/configuration/**"             value-ref="queryConfigurationController"/>
198                                <entry key="/secure/query/definition/result/*/*"        value-ref="secureQueryDefinitionResultController"/>
199                                <entry key="/secure/query/definition/builder/*/*"       value-ref="secureQueryDefinitionBuilderController"/>
201                                <!-- U S E R   P R O F I L E -->
202                                <entry key="/user/Login.html"                                   value-ref="userLoginController"/>
203                                <entry key="/user/Selections.html"                              value-ref="userSelectionsController"/>
205                                <entry key="/user/Registration.html"                    value-ref="userEditRegistrationController"/>
206                                <entry key="/user/registration/save"                    value-ref="userSaveRegistrationController"/>
207                                <entry key="/user/registration/verify/**"               value-ref="userVerifyRegistrationController"/>
209                                <entry key="/user/Access.html"                                  value-ref="userAccessController"/>
210                                <entry key="/user/status"                                               value-ref="userStatusController"/>
211                                <entry key="/user/access/email"                                 value-ref="userEmailAccessController"/>
214                                <!-- G E N E R I C   T R A S F O R M A T I O N -->
215                                <!--
216                                        This controller is needed for adhoc system reports to work. 
217                                        At one point it was thought to not enable this controller as
218                                        it could be a potential security risk because it would bypass
219                                        the spring security mechanism.  However, this is NOT the case
220                                        as the controller only can access xml files within its
221                                        configuration limitation or via the xmlURL request parameter. 
222                                        In either case if there were sensitive data in these files
223                                        they should NEVER be placed in a non secured, public facing
224                                        webapp/directory. 
226                                        To be safe, it is probably still best to remove this request
227                                        from production deployements.  It should only be enabled for
228                                        local query module development and testing environment where
229                                        the QM developer wants to test their XML files.
230                                -->
231                                <entry key="/view.html"                 value-ref="viewHTTPXMLXSLTRequestParameterController"/>
234                                <!-- F I L E   C O N T E N T   S T R E A M E R -->
235                                <entry key="/contentfile/WEB-INF/**"    value-ref="viewAccessDeniedController"/>
236                                <entry key="/contentfile/**"                    value-ref="viewGetFileController"/>
238                        </map>
239                </constructor-arg>
240        </bean>
243        <!--
245                This section provides the adopter a mechanism to override bean definitions
246                and property values.  Theses bean definitions should be listed AFTER ALL
247                imported bean files. 
248        -->
250<!-- uncomment if wanting ss props in the webapps dir.  Make sure to ref this bean below...
251        <bean id="siteSpecificWebappsRootURL" class="org.springframework.beans.factory.config.MethodInvokingFactoryBean">
252                <property name="targetObject" ref="commonContextAndPathService"/>
253                <property name="targetMethod" value="getPathURL"/>
254                <property name="arguments"><list><value>..</value></list></property>
255        </bean>
258        <bean id="siteSpecificPropertyOverrides" class="org.springframework.beans.factory.config.PropertyOverrideConfigurer">
259                <description>
260                        Defines optional special property file(s) that contain property
261                        overrides.  These differ in that the beanID:propertyName is on the
262                        left side with the right containing the value to be injected into
263                        the bean.  Property files are only able to provide string and numeric
264                        type data values/value overrides.  These property files are optional
265                        and might not want to be/need to be used by an adopter to keep their
266                        configuration files more concise and simpler - the property values
267                        can simply be placed in this file.  Where property files are of
268                        value is when being deployed to different servers where each server
269                        has it's own file path, IBISQ url, JNDI name, etc.
271                        The locations define where these override files could be located.
272                        If one exists in all directories then the last definition is the
273                        value that eventually is used.  If the file does not exist the
274                        ignore setting specifies to move on.  If false and a file is not
275                        found then the app will not start. 
277                        For local development in MS-Windows put a
278                        property override file in your c:\users\your_username directory.
279                        Only include those values needed to override/supplement your
280                        current settings already specified.
282                        IMPORTANT NOTES: If you have the files located outside of the webapp
283                        container you need to make sure that the file privs are setup
284                        correctly.  The ${user.home} is a special environment value that
285                        should work for Windows and Linux.  Relative file paths are only
286                        supported for relative paths within the webapp.  For property files
287                        outside of the webapp you must use a fully qualified URL value with
288                        outside relative "../xyz" paths not being fully supported due to
289                        the spring using whatever concreate ResourceLoader object.
291                        Property files can only set a bean's (object) string/numeric values. 
292                </description>
293                <property name="ignoreResourceNotFound" value="true"/>
294                <property name="locations">
295                        <list>
296                                <value>WEB-INF/config/</value>
298                                <!-- if wanting prop file in the webapps dir then
299                                        1) uncomment the below refed bean (above).
300                                        2) uncomment the ref to the bean (below).
301                                <value>#{siteSpecificWebappsRootURL}/</value>
303                                The direct relative to webapp path does NOT work - can't remember
304                                why but debugging showed the path is relative to the app server
305                                - not the app context (can't remember why the sub dir WEB-INF
306                                works?).  Must use the bean which knows about the app context. 
307                                <value>../relative_context_path_that</value>
308                                -->
310                                <value>file:${user.home}/</value>
311                        </list>
312                </property>
313        </bean>
316        <!-- This method invoke call verifies the existance of the published
317                indicators XML file.  If it does not exist then creates it based on the
318                existing IP XML files.  This is useful for new deployments or if the XML
319                is corrupt etc.  Typically used when the adopter wants to rebuild the
320                XML (1. delete the published IPs XML file, 2. restart the app).  The
321                admin app is responsible to maintain the published IPs XML file via an
322                IP publish request so this call should not be needed.  It is provided as
323                a safety feature that some direct content adopters may want to include.
325                REMOTE CONTENT NOTE: this verify service is of no value as the content
326                is located on a different server and thus can NOT create, update, delete
327                this file.  For remote content the IPs XML and published IPs XML file is
328                either managed by the admin app's publishing or by an adopter manually
329                maintaining their content.
330        <bean id="siteSpecificVerifyPublishedIndicatorsXMLFileService"
331                class="org.springframework.beans.factory.config.MethodInvokingFactoryBean"
332        >
333                <property name="targetObject">
334                        <bean class="org.ibisph.indicatorprofile.service.PublishedIndicatorsXML">
335                                <property name="publishedIndicatorsFilePathAndName" value="#{indicatorPublishedIndicatorsFilePathAndName.string}"/>
336                                <property name="indicatorProfileFilePath" value="#{indicatorProfileFilePath.string}"/>
337                                <property name="documentDAOService"             ref="commonPublishedDocumentDAOService"/>
338                        </bean>
339                </property>
340                <property name="targetMethod" value="verifyPublishedIndicatorsXMLFile"/>
341        </bean>
342        -->
345        <bean id="securityAuthenticationProviderList" class="java.util.ArrayList">
346                <description>
347                        Defines the types of provides to be used for authenticating a user.
348                        This list can be 1:n with the first being tried then the next etc
349                        until successful/all providers have been tried.
351                        Note that you MUST have the appropriate/associated spring bean xml
352                        file included/imported to be able to use the selected provider.
353                </description>
354                <constructor-arg>
355                        <list>
356                                <ref bean="securityPreAuthenticatedAuthenticationProvider"/>
357                                <ref bean="securityDBAuthenticationProvider"/>
358                                <ref bean="securityXMLAuthenticationProvider"/>
359                        </list>
360                </constructor-arg>
361        </bean>
363        <!-- For development use the standard, non caching XSLT transformer.  Default
364                common is the caching version: org.ibisph.xslt.CachedSaxonTransformerFactory.
365        -->
366        <bean id="commonXSLTTransformerFactory" class="net.sf.saxon.TransformerFactoryImpl"/>
Note: See TracBrowser for help on using the repository browser.