1 package org.collectionspace.services.common.vocabulary;
4 import java.util.regex.Matcher;
5 import java.util.regex.Pattern;
7 import javax.ws.rs.core.Response;
9 import org.collectionspace.services.client.AuthorityClient;
10 import org.collectionspace.services.client.CollectionSpaceClient;
11 import org.collectionspace.services.client.PoxPayloadIn;
12 import org.collectionspace.services.common.ServiceMain;
13 import org.collectionspace.services.common.api.Tools;
14 import org.collectionspace.services.common.context.MultipartServiceContextImpl;
15 import org.collectionspace.services.common.context.ServiceContext;
16 import org.collectionspace.services.common.vocabulary.RefNameServiceUtils.AuthorityItemSpecifier;
17 import org.collectionspace.services.common.vocabulary.RefNameServiceUtils.Specifier;
18 import org.collectionspace.services.common.vocabulary.nuxeo.AuthorityIdentifierUtils;
19 import org.collectionspace.services.config.service.ServiceBindingType;
20 import org.collectionspace.services.config.tenant.RemoteClientConfig;
21 import org.collectionspace.services.config.tenant.RemoteClientConfigurations;
22 import org.collectionspace.services.config.tenant.TenantBindingType;
23 import org.collectionspace.services.nuxeo.client.java.CoreSessionInterface;
24 import org.collectionspace.services.nuxeo.util.NuxeoUtils;
25 import org.dom4j.DocumentException;
26 import org.nuxeo.ecm.core.api.DocumentModel;
27 import org.slf4j.Logger;
28 import org.slf4j.LoggerFactory;
30 @SuppressWarnings("rawtypes")
31 public class AuthorityServiceUtils {
32 private static final Logger logger = LoggerFactory.getLogger(AuthorityIdentifierUtils.class);
34 // Used to keep track if an authority item's is deprecated
35 public static final String DEFAULT_REMOTECLIENT_CONFIG_NAME = "default";
36 public static final String IS_DEPRECATED_PROPERTY = "IS_DEPRECATED_PROPERTY";
37 public static final Boolean DEPRECATED = true;
38 public static final Boolean NOT_DEPRECATED = !DEPRECATED;
40 // Used to keep track if an authority item's rev number should be updated
41 public static final String SHOULD_UPDATE_REV_PROPERTY = "SHOULD_UPDATE_REV_PROPERTY";
42 public static final boolean UPDATE_REV = true;
43 public static final boolean DONT_UPDATE_REV = !UPDATE_REV;
45 // Used to keep track if an authority item is a locally proposed member of a SAS authority
46 public static final String IS_PROPOSED_PROPERTY = "IS_PROPOSED";
47 public static final Boolean PROPOSED = true;
48 public static final Boolean NOT_PROPOSED = !PROPOSED;
49 public static final Boolean SAS_ITEM = true;
50 public static final Boolean NOT_SAS_ITEM = !SAS_ITEM;
52 public static final Boolean NO_CHANGE = null;
55 * Try to find a named remote client configuration in the current tenant bindings. If the value of the incoming param 'remoteClientConfigName' is
56 * blank or null, we'll try to find a name in the authority service's bindings. If we can't find a name there, we'll try using the default name.
58 * If the incoming param 'remoteClientConfigName' is not null, we'll look through all the named remote client configurations in the tenant's binding
59 * to find the configuration. If we can't find the named configuration, we'll throw an exception.
61 * If there are no remote client configurations in the tenant's bindings, we'll throw an exception.
63 public static final RemoteClientConfig getRemoteClientConfig(ServiceContext ctx, String remoteClientConfigName) throws Exception {
64 RemoteClientConfig result = null;
66 TenantBindingType tenantBinding = ServiceMain.getInstance().getTenantBindingConfigReader().getTenantBinding(ctx.getTenantId());
67 RemoteClientConfigurations remoteClientConfigurations = tenantBinding.getRemoteClientConfigurations();
68 if (remoteClientConfigurations != null) {
69 if (Tools.isEmpty(remoteClientConfigName) == true) {
70 // Since the authority instance didn't specify a remote client config name, let's see if the authority type's service bindings specifies one
71 ServiceBindingType serviceBindingType =
72 ServiceMain.getInstance().getTenantBindingConfigReader().getServiceBinding(ctx.getTenantId(), ctx.getServiceName());
73 remoteClientConfigName = serviceBindingType.getRemoteClientConfigName();
76 // If we still don't have a remote client config name, let's use the default value.
78 if (Tools.isEmpty(remoteClientConfigName) == true) {
79 remoteClientConfigName = DEFAULT_REMOTECLIENT_CONFIG_NAME;
82 List<RemoteClientConfig> remoteClientConfigList = remoteClientConfigurations.getRemoteClientConfig();
83 for (RemoteClientConfig config : remoteClientConfigList) {
84 if (config.getName().equalsIgnoreCase(remoteClientConfigName)) {
90 String errMsg = String.format("No remote client configurations could be found in the tenant bindings for tenant named '%s'.",
93 throw new Exception(errMsg);
97 String errMsg = String.format("Could not find a remote client configuration named '%s' in the tenant bindings for tenant named '%s'",
98 remoteClientConfigName, ctx.getTenantName());
100 throw new Exception(errMsg);
107 * Make a request to the SAS Server for an authority payload.
111 * @param responseType
115 static public PoxPayloadIn requestPayloadInFromRemoteServer(ServiceContext ctx, String remoteClientConfigName, Specifier specifier, Class responseType) throws Exception {
116 PoxPayloadIn result = null;
118 RemoteClientConfig remoteClientConfig = getRemoteClientConfig(ctx, remoteClientConfigName);
119 AuthorityClient client = (AuthorityClient) ctx.getClient(remoteClientConfig);
121 Response res = client.read(specifier.getURNValue());
123 int statusCode = res.getStatus();
125 // Check the status code of the response: does it match
126 // the expected response(s)?
127 if (logger.isDebugEnabled()) {
128 logger.debug(client.getClass().getCanonicalName() + ": status = " + statusCode);
131 result = new PoxPayloadIn((String)res.readEntity(responseType)); // Get the entire response!
140 // Makes a call to the remote SAS server for a authority item payload
142 static public PoxPayloadIn requestPayloadInFromRemoteServer(
143 AuthorityItemSpecifier specifier,
144 String remoteClientConfigName,
147 boolean syncHierarchicalRelationships) throws Exception {
148 PoxPayloadIn result = null;
150 ServiceContext authorityCtx = new MultipartServiceContextImpl(serviceName);
151 RemoteClientConfig remoteClientConfig = getRemoteClientConfig(authorityCtx, remoteClientConfigName);
152 AuthorityClient client = (AuthorityClient) authorityCtx.getClient(remoteClientConfig);
153 Response res = client.readItem(specifier.getParentSpecifier().getURNValue(), specifier.getItemSpecifier().getURNValue(),
154 AuthorityClient.INCLUDE_DELETED_ITEMS, syncHierarchicalRelationships);
157 int statusCode = res.getStatus();
159 // Check the status code of the response: does it match
160 // the expected response(s)?
161 if (logger.isDebugEnabled()) {
162 logger.debug(client.getClass().getCanonicalName() + ": status = " + statusCode);
165 result = new PoxPayloadIn((String)res.readEntity(responseType)); // Get the entire response!
173 static public boolean setAuthorityItemDeprecated(ServiceContext ctx,
174 DocumentModel docModel, String authorityItemCommonSchemaName, Boolean flag) throws Exception {
175 boolean result = false;
177 docModel.setProperty(authorityItemCommonSchemaName, AuthorityItemJAXBSchema.DEPRECATED,
179 CoreSessionInterface repoSession = (CoreSessionInterface) ctx.getCurrentRepositorySession();
180 repoSession.saveDocument(docModel);
187 * The domain name part of refnames on SAS may not match that of local refnames, so we need to update all the payload's
188 * refnames with the correct domain name
190 static public PoxPayloadIn filterRefnameDomains(ServiceContext ctx,
191 PoxPayloadIn payload) throws DocumentException {
192 PoxPayloadIn result = null;
195 String payloadStr = payload.getXmlPayload();
196 Pattern p = Pattern.compile("(urn:cspace:)(([a-z]{1,}\\.?)*)"); // matches the domain name part of a RefName. For example, matches "core.collectionspace.org" of RefName urn:cspace:core.collectionspace.org:personauthorities:name(person):item:name(BigBird1461101206103)'Big Bird'
197 Matcher m = p.matcher(payloadStr);
199 StringBuffer filteredPayloadStr = new StringBuffer();
200 while (m.find() == true) {
201 if (logger.isDebugEnabled()) {
202 logger.debug("Replacing: " + m.group(2));
204 m.appendReplacement(filteredPayloadStr, m.group(1) + ctx.getTenantName());
206 m.appendTail(filteredPayloadStr);
207 result = new PoxPayloadIn(filteredPayloadStr.toString());
209 if (logger.isDebugEnabled()) {
210 logger.debug(String.format("", filteredPayloadStr));
217 * Mark the authority item as deprecated.
223 static public boolean markAuthorityItemAsDeprecated(ServiceContext ctx, String authorityItemCommonSchemaName, AuthorityItemSpecifier authorityItemSpecifier) throws Exception {
224 boolean result = false;
227 DocumentModel docModel = NuxeoUtils.getDocFromSpecifier(ctx, (CoreSessionInterface)ctx.getCurrentRepositorySession(),
228 authorityItemCommonSchemaName, authorityItemSpecifier);
229 result = setAuthorityItemDeprecated(ctx, docModel, authorityItemCommonSchemaName, AuthorityServiceUtils.DEPRECATED);
230 } catch (Exception e) {
231 logger.warn(String.format("Could not mark item '%s' as deprecated.", authorityItemSpecifier.getItemSpecifier().getURNValue()), e);