2 * Copyright (C) 2007 EDIT
3 * European Distributed Institute of Taxonomy
4 * http://www.e-taxonomy.eu
6 * The contents of this file are subject to the Mozilla Public License Version 1.1
7 * See LICENSE.TXT at the top of this package for the full license terms.
10 package eu
.etaxonomy
.taxeditor
.store
;
12 import java
.lang
.reflect
.InvocationTargetException
;
13 import java
.lang
.reflect
.Method
;
14 import java
.lang
.reflect
.Type
;
15 import java
.util
.EnumSet
;
17 import org
.eclipse
.core
.runtime
.IProgressMonitor
;
18 import org
.eclipse
.core
.runtime
.jobs
.Job
;
19 import org
.eclipse
.swt
.widgets
.Display
;
20 import org
.springframework
.core
.io
.ClassPathResource
;
21 import org
.springframework
.core
.io
.Resource
;
22 import org
.springframework
.security
.access
.PermissionEvaluator
;
23 import org
.springframework
.security
.authentication
.ProviderManager
;
24 import org
.springframework
.security
.core
.context
.SecurityContext
;
25 import org
.springframework
.security
.core
.context
.SecurityContextHolder
;
27 import eu
.etaxonomy
.cdm
.api
.application
.CdmApplicationController
;
28 import eu
.etaxonomy
.cdm
.api
.application
.ICdmApplicationConfiguration
;
29 import eu
.etaxonomy
.cdm
.api
.conversation
.ConversationHolder
;
30 import eu
.etaxonomy
.cdm
.api
.service
.IService
;
31 import eu
.etaxonomy
.cdm
.database
.DbSchemaValidation
;
32 import eu
.etaxonomy
.cdm
.database
.ICdmDataSource
;
33 import eu
.etaxonomy
.cdm
.ext
.geo
.IEditGeoService
;
34 import eu
.etaxonomy
.cdm
.model
.common
.CdmBase
;
35 import eu
.etaxonomy
.cdm
.model
.common
.Language
;
36 import eu
.etaxonomy
.cdm
.persistence
.hibernate
.permission
.CRUD
;
37 import eu
.etaxonomy
.cdm
.persistence
.hibernate
.permission
.CdmPermissionEvaluator
;
38 import eu
.etaxonomy
.cdm
.persistence
.hibernate
.permission
.ICdmPermissionEvaluator
;
39 import eu
.etaxonomy
.cdm
.persistence
.hibernate
.permission
.Role
;
40 import eu
.etaxonomy
.taxeditor
.datasource
.CdmDataSourceRepository
;
41 import eu
.etaxonomy
.taxeditor
.io
.ExportManager
;
42 import eu
.etaxonomy
.taxeditor
.io
.ImportManager
;
43 import eu
.etaxonomy
.taxeditor
.preference
.PreferencesUtil
;
44 import eu
.etaxonomy
.taxeditor
.store
.internal
.TaxeditorStorePlugin
;
45 import eu
.etaxonomy
.taxeditor
.view
.datasource
.CdmDataSourceViewPart
;
48 * This implementation of ICdmDataRepository depends on hibernate sessions to
49 * store the data correctly for the current session. No state is held in this
52 * Only methods that either get or manipulate data are exposed here. So this
53 * class acts as a facade for the methods in cdmlib-service.
59 public class CdmStore
{
61 private static final Resource DEFAULT_APPLICATION_CONTEXT
= new ClassPathResource(
62 "/eu/etaxonomy/cdm/editorApplicationContext.xml",
63 TaxeditorStorePlugin
.class);
64 private static final DbSchemaValidation DEFAULT_DB_SCHEMA_VALIDATION
= DbSchemaValidation
.VALIDATE
;
66 private static CdmStore instance
;
68 private final ICdmApplicationConfiguration applicationConfiguration
;
70 private static ContextManager contextManager
= new ContextManager();
72 private static LoginManager loginManager
= new LoginManager();
74 private static TermManager termManager
= new TermManager();
76 private static SearchManager searchManager
= new SearchManager();
78 private static EditorManager editorManager
= new EditorManager();
80 private static CdmStoreConnector job
;
82 private Language language
;
84 private ICdmDataSource cdmDatasource
;
86 private boolean isConnected
;
93 * @return a {@link eu.etaxonomy.taxeditor.store.CdmStore} object.
95 protected static CdmStore
getDefault() {
96 if (instance
!= null && instance
.isConnected
) {
98 } else if (instance
== null || !instance
.isConnected
) {
102 "Application is not connected to a datastore",
104 "The requested operation is only available when "
105 + "connected to a datasource. You may choose a datasource to connect to or create a new one in the datasource view.");
107 StoreUtil
.showView(CdmDataSourceViewPart
.ID
);
111 throw new RuntimeException();
115 * Initialize the with the last edited datasource
117 public static void connect() {
119 ICdmDataSource datasource
= CdmDataSourceRepository
120 .getCurrentDataSource();
126 * Initialize with a specific datasource
129 * a {@link eu.etaxonomy.cdm.database.ICdmDataSource} object.
131 public static void connect(ICdmDataSource datasource
) {
132 connect(datasource
, DEFAULT_DB_SCHEMA_VALIDATION
,
133 DEFAULT_APPLICATION_CONTEXT
);
137 * Initialize and provide
140 * @param dbSchemaValidation
141 * @param applicationContextBean
143 private static void connect(final ICdmDataSource datasource
,
144 final DbSchemaValidation dbSchemaValidation
,
145 final Resource applicationContextBean
) {
146 StoreUtil
.info("Connecting to datasource: " + datasource
);
148 job
= new CdmStoreConnector(Display
.getDefault(), datasource
,
149 dbSchemaValidation
, applicationContextBean
);
151 job
.setPriority(Job
.BUILD
);
156 public static boolean isConnecting() {
157 return job
!= null && job
.getState() == Job
.RUNNING
;
161 * Closes the current application context
164 * a {@link org.eclipse.core.runtime.IProgressMonitor} object.
166 public static void close(final IProgressMonitor monitor
) {
167 Display
.getDefault().asyncExec(new Runnable() {
171 * @see java.lang.Runnable#run()
175 getContextManager().notifyContextAboutToStop(monitor
);
176 if ((monitor
== null || (!monitor
.isCanceled()) && isActive())) {
177 getContextManager().notifyContextStop(monitor
);
184 private void close() {
186 cdmDatasource
= null;
189 static void setInstance(CdmApplicationController applicationController
,
190 ICdmDataSource dataSource
) {
191 instance
= new CdmStore(applicationController
, dataSource
);
194 private CdmStore(CdmApplicationController applicationController
,
195 ICdmDataSource dataSource
) {
196 this.applicationConfiguration
= applicationController
;
197 this.cdmDatasource
= dataSource
;
202 * All calls to the datastore require
206 private ICdmApplicationConfiguration
getApplicationConfiguration() {
208 return applicationConfiguration
;
209 } catch (Exception e
) {
210 StoreUtil
.error(CdmStore
.class, e
);
217 * getCurrentApplicationController
221 * {@link eu.etaxonomy.cdm.api.application.CdmApplicationController}
224 public static ICdmApplicationConfiguration
getCurrentApplicationConfiguration() {
225 if (getDefault() != null) {
226 return getDefault().getApplicationConfiguration();
236 * Creates a new conversation, binds resources to the conversation and start
237 * a transaction for this conversation.
239 * @return a {@link eu.etaxonomy.cdm.api.conversation.ConversationHolder}
242 public static ConversationHolder
createConversation() {
243 ConversationHolder conversation
= getCurrentApplicationConfiguration()
246 conversation
.startTransaction();
248 StoreUtil
.errorDialog("No database connection", CdmStore
.class, "No database connection available", e
);
254 * Generic method that will scan the getters of {@link ICdmApplicationConfiguration} for the given service
255 * interface. If a matching getter is found the according service implementation is returned by
256 * invoking the getter otherwise the method returns <code>null</code>.
259 * @param serviceClass
260 * @return the configured implementation of <code>serviceClass</code> or <code>null</code>
262 public static <T
extends IService
> T
getService(Class
<T
> serviceClass
) {
263 ICdmApplicationConfiguration configuration
= getCurrentApplicationConfiguration();
265 Method
[] methods
= ICdmApplicationConfiguration
.class.getDeclaredMethods();
269 for (Method method
: methods
) {
270 Type type
= method
.getGenericReturnType();
272 if (type
.equals(serviceClass
)) {
274 service
= (T
) method
.invoke(configuration
, null);
276 } catch (IllegalArgumentException e
) {
277 StoreUtil
.error(CdmStore
.class, e
);
278 } catch (IllegalAccessException e
) {
279 StoreUtil
.error(CdmStore
.class, e
);
280 } catch (InvocationTargetException e
) {
281 StoreUtil
.error(CdmStore
.class, e
);
291 * getAuthenticationManager
295 * {@link org.springframework.security.authentication.ProviderManager}
298 public static ProviderManager
getAuthenticationManager() {
299 return getCurrentApplicationConfiguration().getAuthenticationManager();
304 * getAuthenticationManager
308 * {@link ICdmPermissionEvaluator} object.
310 public static ICdmPermissionEvaluator
getPermissionEvaluator() {
311 return getCurrentApplicationConfiguration().getPermissionEvaluator();
319 * @return a {@link eu.etaxonomy.cdm.ext.geo.IEditGeoService} object.
321 public static IEditGeoService
getGeoService() {
322 return (IEditGeoService
) getCurrentApplicationConfiguration().getBean(
327 * SECURITY RELATED CONVENIENCE METHODS
331 * @see org.springframework.security.access.PermissionEvaluator#hasPermission(org.springframework.security.core.Authentication, java.lang.Object, java.lang.Object)
333 * @param targetDomainObject
337 public static boolean currentAuthentiationHasPermission(CdmBase targetDomainObject
, EnumSet
<CRUD
> permission
){
338 //TODO use getCurrentApplicationConfiguration().currentAuthentiationHasPermission(CdmBase targetDomainObject, Operation permission) instead
339 SecurityContext context
= SecurityContextHolder
.getContext();
340 return getPermissionEvaluator().hasPermission(context
.getAuthentication(), targetDomainObject
, permission
);
344 * @see org.springframework.security.access.PermissionEvaluator#hasPermission(org.springframework.security.core.Authentication, java.lang.Object, java.lang.Object)
346 * @param targetDomainObject
350 public static boolean currentAuthentiationHasPermission(Class
<?
extends CdmBase
> targetType
, EnumSet
<CRUD
> permission
){
351 SecurityContext context
= SecurityContextHolder
.getContext();
352 return getPermissionEvaluator().hasPermission(context
.getAuthentication(), null, targetType
.getName(), permission
);
355 public static boolean currentAuthentiationHasOneOfRoles(Role
... roles
){
356 SecurityContext context
= SecurityContextHolder
.getContext();
357 return getPermissionEvaluator().hasOneOfRoles(context
.getAuthentication(), roles
);
369 * @return a {@link eu.etaxonomy.cdm.model.common.Language} object.
371 public static Language
getDefaultLanguage() {
372 if (getDefault().getLanguage() == null) {
373 getDefault().setLanguage(PreferencesUtil
.getGlobalLanguage());
375 return getDefault().getLanguage();
384 * a {@link eu.etaxonomy.cdm.model.common.Language} object.
386 public static void setDefaultLanguage(Language language
) {
387 getDefault().setLanguage(language
);
391 * @return the language
393 private Language
getLanguage() {
399 * the language to set
401 private void setLanguage(Language language
) {
402 this.language
= language
;
411 * Getter for the field <code>loginManager</code>.
414 * @return a {@link eu.etaxonomy.taxeditor.store.LoginManager} object.
416 public static LoginManager
getLoginManager() {
422 * Getter for the field <code>contextManager</code>.
425 * @return a {@link eu.etaxonomy.taxeditor.store.ContextManager} object.
427 public static ContextManager
getContextManager() {
428 return contextManager
;
431 public static TermManager
getTermManager() {
435 public static SearchManager
getSearchManager() {
436 return searchManager
;
439 public static EditorManager
getEditorManager() {
440 return editorManager
;
444 * IMPORT/EXPORT FACTORIES
449 * Getter for the field <code>importHandler</code>.
452 * @return a {@link eu.etaxonomy.taxeditor.io.ImportManager} object.
454 public static ImportManager
getImportManager() {
455 return ImportManager
.NewInstance(getCurrentApplicationConfiguration());
460 * Getter for the field <code>exportHandler</code>.
463 * @return a {@link eu.etaxonomy.taxeditor.io.ExportManager} object.
465 public static ExportManager
getExportManager() {
466 return ExportManager
.NewInstance(getCurrentApplicationConfiguration());
470 * Whether this CdmStore is currently connected to a datasource
474 public static boolean isActive() {
475 return instance
!= null && instance
.isConnected
;
483 * @return a {@link eu.etaxonomy.cdm.database.ICdmDataSource} object.
485 public static ICdmDataSource
getDataSource() {
487 return instance
.getDatasource();
495 private ICdmDataSource
getDatasource() {
496 return cdmDatasource
;