From 0659402f13e43111853aa2ef4038d106c30e56bd Mon Sep 17 00:00:00 2001 From: Tom Page Date: Tue, 19 Apr 2016 16:24:46 +0100 Subject: [PATCH] RM-2812 Mark public API methods with @AlfrescoPublicAPI. --- ...cordsManagementAuditServiceDeprecated.java | 15 ++-- .../caveat/RMCaveatConfigService.java | 2 + .../caveat/RMConstraintInfo.java | 3 + .../caveat/RMListOfValuesConstraint.java | 2 + .../action/RecordsManagementAction.java | 2 + .../RecordsManagementActionCondition.java | 3 + ...dsManagementActionConditionDefinition.java | 6 +- .../RecordsManagementActionDefinition.java | 4 +- .../action/RecordsManagementActionResult.java | 11 ++- .../RecordsManagementActionService.java | 2 + .../admin/CustomMetadataException.java | 7 +- ...ropertyAlreadyExistsMetadataException.java | 6 +- .../admin/RecordsManagementAdminService.java | 2 + .../audit/RecordsManagementAuditService.java | 82 ++++++++++--------- .../capability/Capability.java | 2 + .../capability/CapabilityService.java | 4 +- .../capability/Group.java | 3 + .../dataset/DataSet.java | 9 +- .../dataset/DataSetService.java | 16 ++-- .../DispositionActionDefinition.java | 28 ++++--- .../disposition/DispositionSchedule.java | 29 +++---- .../disposition/DispositionService.java | 1 + .../property/DispositionProperty.java | 2 + .../email/CustomEmailMappingService.java | 3 + .../email/CustomMapping.java | 3 + .../event/RecordsManagementEvent.java | 40 ++++----- .../event/RecordsManagementEventService.java | 3 + .../event/RecordsManagementEventType.java | 15 ++-- .../fileplan/FilePlanComponentKind.java | 3 + .../fileplan/FilePlanService.java | 2 + .../freeze/FreezeService.java | 8 +- .../hold/HoldService.java | 20 +++-- .../identifier/IdentifierGenerator.java | 6 +- .../identifier/IdentifierService.java | 2 + .../model/BaseBehaviourBean.java | 2 + .../model/RecordsManagementCustomModel.java | 2 + .../model/RecordsManagementModel.java | 2 + .../model/security/ModelSecurityService.java | 58 ++++++------- .../model/security/ProtectedAspect.java | 3 + .../security/ProtectedModelArtifact.java | 34 ++++---- .../model/security/ProtectedProperty.java | 9 +- .../record/InplaceRecordService.java | 2 + .../record/RecordService.java | 34 ++++---- .../RecordableVersionConfigService.java | 2 + .../recordfolder/RecordFolderService.java | 2 + .../relationship/Relationship.java | 2 + .../relationship/RelationshipDefinition.java | 3 + .../relationship/RelationshipDisplayName.java | 3 + .../relationship/RelationshipService.java | 12 +-- .../relationship/RelationshipType.java | 3 + .../org_alfresco_module_rm/report/Report.java | 10 ++- .../report/ReportGenerator.java | 6 +- .../report/ReportService.java | 4 +- .../role/FilePlanRoleService.java | 4 +- .../org_alfresco_module_rm/role/Role.java | 2 + .../RecordsManagementSearchParameters.java | 2 + .../RecordsManagementSearchService.java | 38 +++++---- .../RecordsManagementSearchServiceImpl.java | 6 +- .../search/SavedSearchDetails.java | 2 + .../SavedSearchDetailsCompatibility.java | 2 + .../security/ExtendedSecurityService.java | 40 ++++----- .../FilePlanAuthenticationService.java | 1 + .../security/FilePlanPermissionService.java | 26 +++--- .../transfer/TransferService.java | 4 +- .../util/AuthenticationUtil.java | 2 + .../util/ServiceBaseImpl.java | 8 +- .../util/TransactionalResourceHelper.java | 15 ++-- .../version/RecordableVersionService.java | 36 ++++---- .../vital/VitalRecordService.java | 1 + .../java/org/alfresco/util/SortDirection.java | 3 + 70 files changed, 442 insertions(+), 289 deletions(-) diff --git a/rm-community/rm-community-repo/source/compatibility/org/alfresco/module/org_alfresco_module_rm/audit/RecordsManagementAuditServiceDeprecated.java b/rm-community/rm-community-repo/source/compatibility/org/alfresco/module/org_alfresco_module_rm/audit/RecordsManagementAuditServiceDeprecated.java index bce276ff78..0e661bfdaa 100644 --- a/rm-community/rm-community-repo/source/compatibility/org/alfresco/module/org_alfresco_module_rm/audit/RecordsManagementAuditServiceDeprecated.java +++ b/rm-community/rm-community-repo/source/compatibility/org/alfresco/module/org_alfresco_module_rm/audit/RecordsManagementAuditServiceDeprecated.java @@ -36,24 +36,25 @@ import org.alfresco.service.cmr.repository.NodeRef; /** * Deprecated records management audit interface methods. - * + * * @author Roy Wetherall * @since 2.1 + * @deprecated as of 2.1, see {@link RecordsManagementAuditService}. */ -public interface RecordsManagementAuditServiceDeprecated +public interface RecordsManagementAuditServiceDeprecated { /** * @deprecated as of 2.1, see {@link #stop(NodeRef)} */ @Deprecated void stop(); - + /** * @deprecated as of 2.1, see {@link #clear(NodeRef)} */ @Deprecated - void clear(); - + void clear(); + /** * @deprecated as of 2.1, see {@link #isEnabled(NodeRef)} */ @@ -65,12 +66,12 @@ public interface RecordsManagementAuditServiceDeprecated */ @Deprecated Date getDateLastStarted(); - + /** * @deprecated as of 2.1, see {@link #getDateLastStopped(NodeRef)} */ Date getDateLastStopped(); - + /** * @deprecated as of 2.1 */ diff --git a/rm-community/rm-community-repo/source/compatibility/org/alfresco/module/org_alfresco_module_rm/caveat/RMCaveatConfigService.java b/rm-community/rm-community-repo/source/compatibility/org/alfresco/module/org_alfresco_module_rm/caveat/RMCaveatConfigService.java index 4ef215a322..876e06ade7 100644 --- a/rm-community/rm-community-repo/source/compatibility/org/alfresco/module/org_alfresco_module_rm/caveat/RMCaveatConfigService.java +++ b/rm-community/rm-community-repo/source/compatibility/org/alfresco/module/org_alfresco_module_rm/caveat/RMCaveatConfigService.java @@ -33,9 +33,11 @@ import java.util.List; import java.util.Map; import java.util.Set; +import org.alfresco.api.AlfrescoPublicApi; import org.alfresco.error.AlfrescoRuntimeException; import org.alfresco.service.cmr.repository.NodeRef; +@AlfrescoPublicApi public interface RMCaveatConfigService { void init(); diff --git a/rm-community/rm-community-repo/source/compatibility/org/alfresco/module/org_alfresco_module_rm/caveat/RMConstraintInfo.java b/rm-community/rm-community-repo/source/compatibility/org/alfresco/module/org_alfresco_module_rm/caveat/RMConstraintInfo.java index cc6d92cd49..a34099ceac 100644 --- a/rm-community/rm-community-repo/source/compatibility/org/alfresco/module/org_alfresco_module_rm/caveat/RMConstraintInfo.java +++ b/rm-community/rm-community-repo/source/compatibility/org/alfresco/module/org_alfresco_module_rm/caveat/RMConstraintInfo.java @@ -29,6 +29,9 @@ package org.alfresco.module.org_alfresco_module_rm.caveat; import java.util.Arrays; +import org.alfresco.api.AlfrescoPublicApi; + +@AlfrescoPublicApi public class RMConstraintInfo { private String name; diff --git a/rm-community/rm-community-repo/source/compatibility/org/alfresco/module/org_alfresco_module_rm/caveat/RMListOfValuesConstraint.java b/rm-community/rm-community-repo/source/compatibility/org/alfresco/module/org_alfresco_module_rm/caveat/RMListOfValuesConstraint.java index a6e8b51710..ac9b078229 100644 --- a/rm-community/rm-community-repo/source/compatibility/org/alfresco/module/org_alfresco_module_rm/caveat/RMListOfValuesConstraint.java +++ b/rm-community/rm-community-repo/source/compatibility/org/alfresco/module/org_alfresco_module_rm/caveat/RMListOfValuesConstraint.java @@ -33,6 +33,7 @@ import java.util.HashMap; import java.util.List; import java.util.Map; +import org.alfresco.api.AlfrescoPublicApi; import org.alfresco.repo.dictionary.constraint.ListOfValuesConstraint; import org.alfresco.repo.security.authentication.AuthenticationUtil; import org.alfresco.service.cmr.dictionary.ConstraintException; @@ -59,6 +60,7 @@ public class RMListOfValuesConstraint extends ListOfValuesConstraint // defined match logic used by caveat matching (default = "AND") private MatchLogic matchLogic = MatchLogic.AND; + @AlfrescoPublicApi public enum MatchLogic { // closed marking - all values must match diff --git a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/action/RecordsManagementAction.java b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/action/RecordsManagementAction.java index 9ab7add008..02230503ef 100644 --- a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/action/RecordsManagementAction.java +++ b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/action/RecordsManagementAction.java @@ -30,6 +30,7 @@ package org.alfresco.module.org_alfresco_module_rm.action; import java.io.Serializable; import java.util.Map; +import org.alfresco.api.AlfrescoPublicApi; import org.alfresco.service.cmr.repository.NodeRef; /** @@ -37,6 +38,7 @@ import org.alfresco.service.cmr.repository.NodeRef; * * @author Roy Wetherall */ +@AlfrescoPublicApi public interface RecordsManagementAction { /** diff --git a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/action/RecordsManagementActionCondition.java b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/action/RecordsManagementActionCondition.java index 12eed9f7c0..40116e7e6f 100644 --- a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/action/RecordsManagementActionCondition.java +++ b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/action/RecordsManagementActionCondition.java @@ -27,12 +27,15 @@ package org.alfresco.module.org_alfresco_module_rm.action; +import org.alfresco.api.AlfrescoPublicApi; + /** * Record Management Action Condition * * @author Roy Wetherall * @since 2.1 */ +@AlfrescoPublicApi public interface RecordsManagementActionCondition { /** diff --git a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/action/RecordsManagementActionConditionDefinition.java b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/action/RecordsManagementActionConditionDefinition.java index fa66cd6086..eafc22cc33 100644 --- a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/action/RecordsManagementActionConditionDefinition.java +++ b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/action/RecordsManagementActionConditionDefinition.java @@ -27,16 +27,18 @@ package org.alfresco.module.org_alfresco_module_rm.action; +import org.alfresco.api.AlfrescoPublicApi; import org.alfresco.service.cmr.action.ActionConditionDefinition; /** * Records management condition definition. - * + * * Primarily used as a marker interface. - * + * * @author Roy Wetherall * @since 2.1 */ +@AlfrescoPublicApi public interface RecordsManagementActionConditionDefinition extends ActionConditionDefinition { } diff --git a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/action/RecordsManagementActionDefinition.java b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/action/RecordsManagementActionDefinition.java index e537ad6cfc..8764b99b21 100644 --- a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/action/RecordsManagementActionDefinition.java +++ b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/action/RecordsManagementActionDefinition.java @@ -29,15 +29,17 @@ package org.alfresco.module.org_alfresco_module_rm.action; import java.util.Set; +import org.alfresco.api.AlfrescoPublicApi; import org.alfresco.module.org_alfresco_module_rm.fileplan.FilePlanComponentKind; import org.alfresco.service.cmr.action.ActionDefinition; /** * Extended action definition interface. - * + * * @author Roy Wetherall * @since 2.1 */ +@AlfrescoPublicApi public interface RecordsManagementActionDefinition extends ActionDefinition { /** diff --git a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/action/RecordsManagementActionResult.java b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/action/RecordsManagementActionResult.java index a0540e796f..a6780abe4a 100644 --- a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/action/RecordsManagementActionResult.java +++ b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/action/RecordsManagementActionResult.java @@ -27,26 +27,29 @@ package org.alfresco.module.org_alfresco_module_rm.action; +import org.alfresco.api.AlfrescoPublicApi; + /** * Records management action result. - * + * * @author Roy Wetherall */ +@AlfrescoPublicApi public class RecordsManagementActionResult { /** Result value */ private Object value; - + /** * Constructor. - * + * * @param value result value */ public RecordsManagementActionResult(Object value) { this.value = value; } - + /** * @return result value */ diff --git a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/action/RecordsManagementActionService.java b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/action/RecordsManagementActionService.java index c9531eb5be..eaaa887c86 100644 --- a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/action/RecordsManagementActionService.java +++ b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/action/RecordsManagementActionService.java @@ -31,6 +31,7 @@ import java.io.Serializable; import java.util.List; import java.util.Map; +import org.alfresco.api.AlfrescoPublicApi; import org.alfresco.service.cmr.repository.NodeRef; @@ -39,6 +40,7 @@ import org.alfresco.service.cmr.repository.NodeRef; * * @author Roy Wetherall */ +@AlfrescoPublicApi public interface RecordsManagementActionService { /** diff --git a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/admin/CustomMetadataException.java b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/admin/CustomMetadataException.java index 90c468e56d..3763bb6b76 100644 --- a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/admin/CustomMetadataException.java +++ b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/admin/CustomMetadataException.java @@ -27,17 +27,20 @@ package org.alfresco.module.org_alfresco_module_rm.admin; +import org.alfresco.api.AlfrescoPublicApi; + /** * Custom metadata exception. - * + * * @author Roy Wethearll * @since 2.1 * @see org.alfresco.module.org_alfresco_module_rm.CustomMetadataException */ +@AlfrescoPublicApi public abstract class CustomMetadataException extends Exception { private static final long serialVersionUID = -6676112294794381360L; - + public CustomMetadataException(String msg) { super(msg); diff --git a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/admin/PropertyAlreadyExistsMetadataException.java b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/admin/PropertyAlreadyExistsMetadataException.java index 7ddfb7bf0b..6814ba6d36 100644 --- a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/admin/PropertyAlreadyExistsMetadataException.java +++ b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/admin/PropertyAlreadyExistsMetadataException.java @@ -27,21 +27,23 @@ package org.alfresco.module.org_alfresco_module_rm.admin; +import org.alfresco.api.AlfrescoPublicApi; import org.springframework.extensions.surf.util.I18NUtil; /** * Custom metadata exception. - * + * * @author Roy Wethearll * @since 2.1 * @see org.alfresco.module.org_alfresco_module_rm.PropertyAlreadyExistsMetadataException */ +@AlfrescoPublicApi public class PropertyAlreadyExistsMetadataException extends CustomMetadataException { private static final long serialVersionUID = -6194867814140009959L; public static final String MSG_PROPERTY_ALREADY_EXISTS = "rm.admin.property-already-exists"; - + public PropertyAlreadyExistsMetadataException(String propIdAsString) { super(I18NUtil.getMessage(MSG_PROPERTY_ALREADY_EXISTS, propIdAsString)); diff --git a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/admin/RecordsManagementAdminService.java b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/admin/RecordsManagementAdminService.java index 55fb5743ca..f904c75357 100644 --- a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/admin/RecordsManagementAdminService.java +++ b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/admin/RecordsManagementAdminService.java @@ -31,6 +31,7 @@ import java.util.List; import java.util.Map; import java.util.Set; +import org.alfresco.api.AlfrescoPublicApi; import org.alfresco.error.AlfrescoRuntimeException; import org.alfresco.module.org_alfresco_module_rm.caveat.RMListOfValuesConstraint.MatchLogic; import org.alfresco.module.org_alfresco_module_rm.relationship.RelationshipService; @@ -52,6 +53,7 @@ import org.alfresco.service.namespace.RegexQNamePattern; * @since 2.1 * @see org.alfresco.module.org_alfresco_module_rm.RecordsManagementAdminService */ +@AlfrescoPublicApi public interface RecordsManagementAdminService { /** diff --git a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/audit/RecordsManagementAuditService.java b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/audit/RecordsManagementAuditService.java index c420f8181d..00e3e50f23 100644 --- a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/audit/RecordsManagementAuditService.java +++ b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/audit/RecordsManagementAuditService.java @@ -39,18 +39,20 @@ import org.alfresco.service.namespace.QName; /** * Records management audit service. - * + * * @author Gavin Cornwell */ +// Not @AlfrescoPublicApi as extends the deprecated class RecordsManagementAuditServiceDeprecated. +@SuppressWarnings("deprecation") public interface RecordsManagementAuditService extends RecordsManagementAuditServiceDeprecated { public enum ReportFormat { HTML, JSON } - - - + + + /** * Retrieves a list of audit events. - * + * * @return List of audit events */ List getAuditEvents(); @@ -60,32 +62,32 @@ public interface RecordsManagementAuditService extends RecordsManagementAuditSer *

* Creates an instance of a simple audit event and registers it with * the service. - * + * * @param name name of audit event * @param label display label of audit event */ void registerAuditEvent(String name, String label); - + /** * Register audit event. - * + * * @param auditEvent audit event */ void registerAuditEvent(AuditEvent auditEvent); - + /** * Audits an event, assumes no properties where modified and that the event should not be audited - * immediately. - * + * immediately. + * * @param nodeRef node reference * @param eventName event name */ - void auditEvent(NodeRef nodeRef, + void auditEvent(NodeRef nodeRef, String eventName); - + /** * Audits an event, assumes that the event should not be audited immediately and not be removed if no property is changed. - * + * * @param nodeRef node reference * @param eventName event name * @param before property values before event @@ -95,10 +97,10 @@ public interface RecordsManagementAuditService extends RecordsManagementAuditSer String eventName, Map before, Map after); - + /** * Audit event, assumes not to be removed if no property is changed. - * + * * @param nodeRef node reference * @param eventName event name * @param before property values before event @@ -110,10 +112,10 @@ public interface RecordsManagementAuditService extends RecordsManagementAuditSer Map before, Map after, boolean immediate); - + /** * Audit event. - * + * * @param nodeRef node reference * @param eventName event name * @param before property values before event @@ -127,52 +129,52 @@ public interface RecordsManagementAuditService extends RecordsManagementAuditSer Map after, boolean immediate, boolean removeIfNoPropertyChanged); - + /** * Determines whether the RM audit log is currently enabled. - * + * * @param filePlan file plan * @return true if RM auditing is active false otherwise */ - boolean isAuditLogEnabled(NodeRef filePlan); - + boolean isAuditLogEnabled(NodeRef filePlan); + /** * Start RM auditing. - * + * * @param filePlan file plan */ void startAuditLog(NodeRef filePlan); - + /** * Stop RM auditing. - * + * * @param filePlan file plan - */ + */ void stopAuditLog(NodeRef filePlan); - - + + /** * Clears the RM audit. - * + * * @param filePlan file plan */ void clearAuditLog(NodeRef filePlan); - + /** * Returns the date the RM audit was last started. - * - * @param filePlan file plan + * + * @param filePlan file plan * @return Date the audit was last started */ Date getDateAuditLogLastStarted(NodeRef filePlan); /** * Returns the date the RM audit was last stopped. - * + * * @return Date the audit was last stopped */ Date getDateAuditLogLastStopped(NodeRef filePlan); - + /** * Retrieves a list of audit log entries using the provided parameters * represented by the RecordsManagementAuditQueryParameters instance. @@ -181,13 +183,13 @@ public interface RecordsManagementAuditService extends RecordsManagementAuditSer * object will result in ALL audit log entries for the RM system being * returned. Setting the various parameters effectively filters the full * audit trail. - * + * * @param params Parameters to use to retrieve audit trail (never null) * @param format The format the report should be produced in * @return File containing JSON representation of audit trail */ File getAuditTrailFile(RecordsManagementAuditQueryParameters params, ReportFormat format); - + /** * Retrieves a list of audit log entries using the provided parameters * represented by the RecordsManagementAuditQueryParameters instance. @@ -196,23 +198,23 @@ public interface RecordsManagementAuditService extends RecordsManagementAuditSer * object will result in ALL audit log entries for the RM system being * returned. Setting the various parameters effectively filters the full * audit trail. - * + * * @param params Parameters to use to retrieve audit trail (never null) * @return All entries for the audit trail */ List getAuditTrail(RecordsManagementAuditQueryParameters params); - + /** * Retrieves a list of audit log entries using the provided parameters * represented by the RecordsManagementAuditQueryParameters instance and - * then files the resulting log as an undeclared record in the record folder + * then files the resulting log as an undeclared record in the record folder * represented by the given NodeRef. *

* The parameters are all optional so an empty RecordsManagementAuditQueryParameters * object will result in ALL audit log entries for the RM system being * returned. Setting the various parameters effectively filters the full * audit trail. - * + * * @param params Parameters to use to retrieve audit trail (never null) * @param destination NodeRef representing a record folder in which to file the audit log * @param format The format the report should be produced in diff --git a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/capability/Capability.java b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/capability/Capability.java index e7175247fa..7eb4280dde 100644 --- a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/capability/Capability.java +++ b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/capability/Capability.java @@ -27,6 +27,7 @@ package org.alfresco.module.org_alfresco_module_rm.capability; +import org.alfresco.api.AlfrescoPublicApi; import org.alfresco.service.cmr.repository.NodeRef; import org.alfresco.service.cmr.security.AccessStatus; @@ -36,6 +37,7 @@ import org.alfresco.service.cmr.security.AccessStatus; * @author andyh * @author Roy Wetherall */ +@AlfrescoPublicApi public interface Capability { /** diff --git a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/capability/CapabilityService.java b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/capability/CapabilityService.java index ae6ed4c476..a6fe9e3d1d 100644 --- a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/capability/CapabilityService.java +++ b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/capability/CapabilityService.java @@ -31,6 +31,7 @@ import java.util.List; import java.util.Map; import java.util.Set; +import org.alfresco.api.AlfrescoPublicApi; import org.alfresco.service.cmr.repository.NodeRef; import org.alfresco.service.cmr.security.AccessStatus; @@ -40,6 +41,7 @@ import org.alfresco.service.cmr.security.AccessStatus; * @author Roy Wetherall * @since 2.0 */ +@AlfrescoPublicApi public interface CapabilityService { /** @@ -108,7 +110,7 @@ public interface CapabilityService /** * Gets the list of all the capability groups (in index order) * - * @return {@link List}<{@link Group}> List of all the capability groups (in index order) + * @return {@link List}<{@link Group}> List of all the capability groups (in index order) */ List getGroups(); diff --git a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/capability/Group.java b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/capability/Group.java index 50160a22a2..a63e643da4 100644 --- a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/capability/Group.java +++ b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/capability/Group.java @@ -27,12 +27,15 @@ package org.alfresco.module.org_alfresco_module_rm.capability; +import org.alfresco.api.AlfrescoPublicApi; + /** * Group interface * * @author Tuna Aksoy * @since 2.1 */ +@AlfrescoPublicApi public interface Group { /** diff --git a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/dataset/DataSet.java b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/dataset/DataSet.java index 4549ba796e..99a1079b86 100644 --- a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/dataset/DataSet.java +++ b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/dataset/DataSet.java @@ -27,26 +27,29 @@ package org.alfresco.module.org_alfresco_module_rm.dataset; +import org.alfresco.api.AlfrescoPublicApi; + +@AlfrescoPublicApi public interface DataSet { /** * Gets the label of the data set - * + * * @return String the label of the data set */ String getLabel(); /** * Gets the id of the data set - * + * * @return String the id of the data set */ String getId(); /** * Gets the path of the data set - * + * * @return String the path of the data set */ String getPath(); diff --git a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/dataset/DataSetService.java b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/dataset/DataSetService.java index a54e0fbce8..5453503c65 100644 --- a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/dataset/DataSetService.java +++ b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/dataset/DataSetService.java @@ -29,21 +29,23 @@ package org.alfresco.module.org_alfresco_module_rm.dataset; import java.util.Map; +import org.alfresco.api.AlfrescoPublicApi; import org.alfresco.service.cmr.repository.NodeRef; +@AlfrescoPublicApi public interface DataSetService { /** * Register a data set implementation with the service - * + * * @param dataSet the data set */ void register(DataSet dataSet); /** * Gets the details of all available data sets. - * + * * @return Map details of all available data sets */ Map getDataSets(); @@ -51,7 +53,7 @@ public interface DataSetService /** * Gets the details of all available data sets for a file plan depending on * the parameter "excludeLoaded". - * + * * @param filePlan the file plan for which the details should be retrieved * @param excludeLoaded if true only data sets will be retrieved which has * not been loaded @@ -63,7 +65,7 @@ public interface DataSetService /** * Gets the details of all loaded data sets for a specified file plan - * + * * @param filePlan the file plan for which the loaded data sets should be * retrieved * @return Map details of all loaded data sets or an empty @@ -74,7 +76,7 @@ public interface DataSetService /** * Loads the data set with the specified id into the specified file plan - * + * * @param filePlan the file plan which the data set will load into * @param dataSetId the id of the data set which will be imported */ @@ -82,7 +84,7 @@ public interface DataSetService /** * Checks if a data set exists with the given data set id - * + * * @param dataSetId the id of the data set which will be checked * @return true if the data set exists, false otherwise */ @@ -91,7 +93,7 @@ public interface DataSetService /** * Checks if a data set with the id "dataSetId" has been loaded into the * specified file plan - * + * * @param filePlan the file plan for which the check should be done * @param dataSetId the id of the data set which should be checked if it has * been loaded to the file plan diff --git a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/disposition/DispositionActionDefinition.java b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/disposition/DispositionActionDefinition.java index 328111cd49..894ef2b1d8 100644 --- a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/disposition/DispositionActionDefinition.java +++ b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/disposition/DispositionActionDefinition.java @@ -29,6 +29,7 @@ package org.alfresco.module.org_alfresco_module_rm.disposition; import java.util.List; +import org.alfresco.api.AlfrescoPublicApi; import org.alfresco.module.org_alfresco_module_rm.event.RecordsManagementEvent; import org.alfresco.service.cmr.repository.NodeRef; import org.alfresco.service.cmr.repository.Period; @@ -36,70 +37,71 @@ import org.alfresco.service.namespace.QName; /** * Disposition action interface - * + * * @author Roy Wetherall */ +// Not @AlfrescoPublicApi because it depends on Period which is not part of the public API. public interface DispositionActionDefinition { /** * Get the NodeRef that represents the disposition action definition - * + * * @return NodeRef of disposition action definition */ NodeRef getNodeRef(); /** * Get disposition action id - * + * * @return String id */ String getId(); /** * Get the index of the action within the disposition instructions - * + * * @return int disposition action index */ int getIndex(); /** * Get the name of disposition action - * + * * @return String name */ String getName(); /** * Get the display label of the disposition action - * + * * @return String name's display label */ String getLabel(); /** * Get the description of the disposition action - * + * * @return String description */ String getDescription(); /** * Get the period for the disposition action - * + * * @return Period disposition period */ Period getPeriod(); /** * Property to which the period is relative to - * + * * @return QName property name */ QName getPeriodProperty(); /** * List of events for the disposition - * + * * @return List list of events */ List getEvents(); @@ -108,7 +110,7 @@ public interface DispositionActionDefinition * Indicates whether the disposition action is eligible when the earliest * event is complete, otherwise all events must be complete before * eligibility. - * + * * @return boolean true if eligible on first action complete, false * otherwise */ @@ -116,14 +118,14 @@ public interface DispositionActionDefinition /** * Get the location of the disposition (can be null) - * + * * @return String disposition location */ String getLocation(); /** * Get the ghost on destroy from the disposition - * + * * @return boolean the gost on destroy flag (on applicable to destroy * actions) */ diff --git a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/disposition/DispositionSchedule.java b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/disposition/DispositionSchedule.java index 67e0743ad5..dce5a8c527 100644 --- a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/disposition/DispositionSchedule.java +++ b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/disposition/DispositionSchedule.java @@ -33,57 +33,58 @@ import org.alfresco.service.cmr.repository.NodeRef; /** * Disposition schedule interface - * + * * @author Roy Wetherall */ +// Not @AlfrescoPublicApi because it depends on DispositionActionDefinition which is not part of the public API. public interface DispositionSchedule { /** * Get the NodeRef that represents the disposition schedule - * + * * @return {@link NodeRef} of disposition schedule */ NodeRef getNodeRef(); - + /** * Get the disposition authority - * + * * @return {@link String} disposition authority */ String getDispositionAuthority(); - + /** * Get the disposition instructions - * + * * @return {@link String} disposition instructions */ String getDispositionInstructions(); - + /** * Indicates whether the disposal occurs at record level or not - * + * * @return boolean true if at record level, false otherwise */ boolean isRecordLevelDisposition(); - + /** * Gets all the disposition action definitions for the schedule - * + * * @return List<{@link DispositionActionDefinition}> disposition action definitions */ List getDispositionActionDefinitions(); - + /** * Get the disposition action definition - * + * * @param id the action definition id * @return {@link DispositionActionDefinition} disposition action definition */ DispositionActionDefinition getDispositionActionDefinition(String id); - + /** * Get the disposition action definition by the name of the disposition action - * + * * @param name disposition action name * @return {@link DispositionActionDefinition} disposition action definition, null if none */ diff --git a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/disposition/DispositionService.java b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/disposition/DispositionService.java index 96bdeed18d..f5e649fd0d 100644 --- a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/disposition/DispositionService.java +++ b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/disposition/DispositionService.java @@ -42,6 +42,7 @@ import org.alfresco.service.namespace.QName; * @author Roy Wetherall * @since 2.0 */ +// Not @AlfrescoPublicApi because it depends on DispositionSchedule which is not part of the public API. public interface DispositionService { /** ========= Disposition Property Methods ========= */ diff --git a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/disposition/property/DispositionProperty.java b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/disposition/property/DispositionProperty.java index 9ae27e4852..c440f3b3c0 100644 --- a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/disposition/property/DispositionProperty.java +++ b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/disposition/property/DispositionProperty.java @@ -32,6 +32,7 @@ import java.util.Date; import java.util.Map; import java.util.Set; +import org.alfresco.api.AlfrescoPublicApi; import org.alfresco.error.AlfrescoRuntimeException; import org.alfresco.module.org_alfresco_module_rm.disposition.DispositionAction; import org.alfresco.module.org_alfresco_module_rm.disposition.DispositionActionDefinition; @@ -55,6 +56,7 @@ import org.alfresco.service.namespace.QName; * * @author Roy Wetherall */ +@AlfrescoPublicApi @BehaviourBean public class DispositionProperty extends BaseBehaviourBean implements NodeServicePolicies.OnUpdatePropertiesPolicy diff --git a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/email/CustomEmailMappingService.java b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/email/CustomEmailMappingService.java index 7ef98fb654..5da1938b87 100644 --- a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/email/CustomEmailMappingService.java +++ b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/email/CustomEmailMappingService.java @@ -30,9 +30,12 @@ package org.alfresco.module.org_alfresco_module_rm.email; import java.util.List; import java.util.Set; +import org.alfresco.api.AlfrescoPublicApi; + /** * Custom EMail Mapping Service */ +@AlfrescoPublicApi public interface CustomEmailMappingService { /** diff --git a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/email/CustomMapping.java b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/email/CustomMapping.java index ec347337ad..d3df3450fa 100644 --- a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/email/CustomMapping.java +++ b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/email/CustomMapping.java @@ -27,9 +27,12 @@ package org.alfresco.module.org_alfresco_module_rm.email; +import org.alfresco.api.AlfrescoPublicApi; + /** * Custom EMail Mapping */ +@AlfrescoPublicApi public class CustomMapping { private String from; diff --git a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/event/RecordsManagementEvent.java b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/event/RecordsManagementEvent.java index 8665a99269..a033023a7f 100644 --- a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/event/RecordsManagementEvent.java +++ b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/event/RecordsManagementEvent.java @@ -27,28 +27,30 @@ package org.alfresco.module.org_alfresco_module_rm.event; +import org.alfresco.api.AlfrescoPublicApi; import org.alfresco.util.ParameterCheck; /** - * Records management event - * + * Records management event + * * @author Roy Wetherall * @since 1.0 */ +@AlfrescoPublicApi public class RecordsManagementEvent -{ +{ /** Records management event type */ private RecordsManagementEventType type; - + /** Records management event name */ private String name; - + /** Records management display label */ private String displayLabel; - + /** * Constructor - * + * * @param type event type * @param name event name * @param displayLabel event display label @@ -58,50 +60,50 @@ public class RecordsManagementEvent ParameterCheck.mandatory("type", type); ParameterCheck.mandatory("name", name); ParameterCheck.mandatory("displayLabel", displayLabel); - + this.type = type; this.name = name; this.displayLabel = displayLabel; } - + /** * Get records management type name - * + * * @return String records management event type name */ public String getType() { return type.getName(); } - + /** * Get the records management event type. - * - * @return {@link RecordsManagementEventType} records management event type - * + * + * @return {@link RecordsManagementEventType} records management event type + * * @since 2.2 */ public RecordsManagementEventType getRecordsManagementEventType() { return type; } - + /** * Event name - * + * * @return String event name */ public String getName() { return this.name; } - + /** - * + * * @return */ public String getDisplayLabel() { return displayLabel; - } + } } diff --git a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/event/RecordsManagementEventService.java b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/event/RecordsManagementEventService.java index e40a6c0cde..aa67d83d27 100644 --- a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/event/RecordsManagementEventService.java +++ b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/event/RecordsManagementEventService.java @@ -29,11 +29,14 @@ package org.alfresco.module.org_alfresco_module_rm.event; import java.util.List; +import org.alfresco.api.AlfrescoPublicApi; + /** * Records management event service interface * * @author Roy Wetherall */ +@AlfrescoPublicApi public interface RecordsManagementEventService { /** diff --git a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/event/RecordsManagementEventType.java b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/event/RecordsManagementEventType.java index 0ff7397762..c49a013ebe 100644 --- a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/event/RecordsManagementEventType.java +++ b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/event/RecordsManagementEventType.java @@ -27,30 +27,33 @@ package org.alfresco.module.org_alfresco_module_rm.event; +import org.alfresco.api.AlfrescoPublicApi; + /** * Records management event type interface - * + * * @author Roy Wetherall */ +@AlfrescoPublicApi public interface RecordsManagementEventType { /** * Get the name of the records management event type - * + * * @return String event type name */ String getName(); - + /** * Gets the display label of the event type - * + * * @return String display label */ String getDisplayLabel(); - + /** * Indicates whether the event is automatic or not - * + * * @return boolean true if automatic, false otherwise */ boolean isAutomaticEvent(); diff --git a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/fileplan/FilePlanComponentKind.java b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/fileplan/FilePlanComponentKind.java index d1787d9ed9..97117c1f95 100644 --- a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/fileplan/FilePlanComponentKind.java +++ b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/fileplan/FilePlanComponentKind.java @@ -27,6 +27,8 @@ package org.alfresco.module.org_alfresco_module_rm.fileplan; +import org.alfresco.api.AlfrescoPublicApi; + /** * File plan component kind enumeration class. *
@@ -35,6 +37,7 @@ package org.alfresco.module.org_alfresco_module_rm.fileplan; * * @author Roy Wetherall */ +@AlfrescoPublicApi public enum FilePlanComponentKind { FILE_PLAN_COMPONENT, diff --git a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/fileplan/FilePlanService.java b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/fileplan/FilePlanService.java index 6b5c8072db..8c35df5210 100644 --- a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/fileplan/FilePlanService.java +++ b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/fileplan/FilePlanService.java @@ -32,6 +32,7 @@ import java.util.List; import java.util.Map; import java.util.Set; +import org.alfresco.api.AlfrescoPublicApi; import org.alfresco.service.cmr.repository.NodeRef; import org.alfresco.service.cmr.repository.StoreRef; import org.alfresco.service.namespace.QName; @@ -42,6 +43,7 @@ import org.alfresco.service.namespace.QName; * @author Roy Wetherall * @since 2.1 */ +@AlfrescoPublicApi public interface FilePlanService { /** diff --git a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/freeze/FreezeService.java b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/freeze/FreezeService.java index f218dd9af0..4b68c4eaae 100644 --- a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/freeze/FreezeService.java +++ b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/freeze/FreezeService.java @@ -30,17 +30,19 @@ package org.alfresco.module.org_alfresco_module_rm.freeze; import java.util.Date; import java.util.Set; +import org.alfresco.api.AlfrescoPublicApi; import org.alfresco.module.org_alfresco_module_rm.hold.HoldService; import org.alfresco.service.cmr.repository.NodeRef; /** * Freeze Service Interface - * + * * TODO should be deprecated and methods moved to the HoldService with "hold, held, etc" style names * * @author Roy Wetherall * @since 2.0 */ +@AlfrescoPublicApi public interface FreezeService { /** @@ -74,12 +76,12 @@ public interface FreezeService * @return String The initiator of the freeze or null */ String getFreezeInitiator(NodeRef nodeRef); - + /** * @deprecated as of 2.2, use {@link HoldService#isHold(NodeRef)} instead. */ @Deprecated - boolean isHold(NodeRef nodeRef); + boolean isHold(NodeRef nodeRef); /** * @deprecated as of 2.2, use {@link HoldService#getHeld(NodeRef)} instead. diff --git a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/hold/HoldService.java b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/hold/HoldService.java index 869738f556..abdf523ebb 100644 --- a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/hold/HoldService.java +++ b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/hold/HoldService.java @@ -29,6 +29,7 @@ package org.alfresco.module.org_alfresco_module_rm.hold; import java.util.List; +import org.alfresco.api.AlfrescoPublicApi; import org.alfresco.service.cmr.repository.NodeRef; /** @@ -37,6 +38,7 @@ import org.alfresco.service.cmr.repository.NodeRef; * @author Tuna Aksoy * @since 2.2 */ +@AlfrescoPublicApi public interface HoldService { /** @@ -58,7 +60,7 @@ public interface HoldService /** * Gets the node reference for the hold with the given name in the given file plan - * + * * @param name {@link String} The name of the hold * @return {@link NodeRef} of the hold with the given name */ @@ -75,8 +77,8 @@ public interface HoldService List heldBy(NodeRef nodeRef, boolean includedInHold); /** - * Gets the list of item node references which are in the given hold - * + * Gets the list of item node references which are in the given hold + * * @param hold {@link NodeRef} of the hold * @return Lost of item {@link NodeRef}s which are in the given hold */ @@ -84,7 +86,7 @@ public interface HoldService /** * Creates a hold with the given name, reason and description for the given file plan - * + * * @param filePlan The {@link NodeRef} of the file plan * @param name {@link String} The name of the hold * @param reason {@link String} The reason of the hold @@ -95,7 +97,7 @@ public interface HoldService /** * Gets the hold reason for the given hold node reference - * + * * @param hold The {@link NodeRef} of the hold * @return {@link String} The reason of the hold */ @@ -103,7 +105,7 @@ public interface HoldService /** * Sets the hold reason - * + * * @param hold The {@link NodeRef} of the hold * @param reason {@link String} The reason for the hold */ @@ -111,7 +113,7 @@ public interface HoldService /** * Deletes the hold - * + * * @param hold The {@link NodeRef} of the hold */ void deleteHold(NodeRef hold); @@ -126,7 +128,7 @@ public interface HoldService /** * Adds the items to the the given hold - * + * * @param hold The {@link NodeRef} of the hold to which the items will be added * @param nodeRefs The item {@link NodeRef}s which will be added to the hold */ @@ -158,7 +160,7 @@ public interface HoldService /** * Removes the given items from the given hold - * + * * @param hold The hold {@link NodeRef} from which the given items will be removed * @param nodeRefs The list of items which will be removed from the given holds */ diff --git a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/identifier/IdentifierGenerator.java b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/identifier/IdentifierGenerator.java index 6f33264aab..79194fb16e 100644 --- a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/identifier/IdentifierGenerator.java +++ b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/identifier/IdentifierGenerator.java @@ -30,13 +30,15 @@ package org.alfresco.module.org_alfresco_module_rm.identifier; import java.io.Serializable; import java.util.Map; +import org.alfresco.api.AlfrescoPublicApi; import org.alfresco.service.namespace.QName; /** * Generates an identifier for a content type from a given context. - * + * * @author Roy Wetherall */ +@AlfrescoPublicApi public interface IdentifierGenerator { /** @@ -44,7 +46,7 @@ public interface IdentifierGenerator * @return QName the type */ QName getType(); - + /** * Generates the next id based on the provided context. * @param context map of context values diff --git a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/identifier/IdentifierService.java b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/identifier/IdentifierService.java index 7338f8bce8..a66c897c97 100644 --- a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/identifier/IdentifierService.java +++ b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/identifier/IdentifierService.java @@ -27,6 +27,7 @@ package org.alfresco.module.org_alfresco_module_rm.identifier; +import org.alfresco.api.AlfrescoPublicApi; import org.alfresco.service.cmr.repository.NodeRef; import org.alfresco.service.namespace.QName; @@ -35,6 +36,7 @@ import org.alfresco.service.namespace.QName; * * @author Roy Wetherall */ +@AlfrescoPublicApi public interface IdentifierService { /** Context value names */ diff --git a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/model/BaseBehaviourBean.java b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/model/BaseBehaviourBean.java index accd90e76a..77e8ee3b13 100644 --- a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/model/BaseBehaviourBean.java +++ b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/model/BaseBehaviourBean.java @@ -30,6 +30,7 @@ package org.alfresco.module.org_alfresco_module_rm.model; import java.util.HashMap; import java.util.Map; +import org.alfresco.api.AlfrescoPublicApi; import org.alfresco.error.AlfrescoRuntimeException; import org.alfresco.module.org_alfresco_module_rm.util.ServiceBaseImpl; import org.alfresco.repo.policy.BehaviourFilter; @@ -43,6 +44,7 @@ import org.apache.commons.logging.LogFactory; * @author Roy Wetherall * @since 2.2 */ +@AlfrescoPublicApi public abstract class BaseBehaviourBean extends ServiceBaseImpl implements RecordsManagementModel, BehaviourRegistry diff --git a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/model/RecordsManagementCustomModel.java b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/model/RecordsManagementCustomModel.java index cc95f65031..d21b67036c 100644 --- a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/model/RecordsManagementCustomModel.java +++ b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/model/RecordsManagementCustomModel.java @@ -27,6 +27,7 @@ package org.alfresco.module.org_alfresco_module_rm.model; +import org.alfresco.api.AlfrescoPublicApi; import org.alfresco.service.namespace.QName; /** @@ -34,6 +35,7 @@ import org.alfresco.service.namespace.QName; * * @author Gavin Cornwell */ +@AlfrescoPublicApi public interface RecordsManagementCustomModel { // Namespace details diff --git a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/model/RecordsManagementModel.java b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/model/RecordsManagementModel.java index 52abff0010..b6ac5067d2 100644 --- a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/model/RecordsManagementModel.java +++ b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/model/RecordsManagementModel.java @@ -27,6 +27,7 @@ package org.alfresco.module.org_alfresco_module_rm.model; +import org.alfresco.api.AlfrescoPublicApi; import org.alfresco.service.namespace.QName; /** @@ -34,6 +35,7 @@ import org.alfresco.service.namespace.QName; * * @author Roy Wetherall */ +@AlfrescoPublicApi public interface RecordsManagementModel extends RecordsManagementCustomModel { // Namespace details diff --git a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/model/security/ModelSecurityService.java b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/model/security/ModelSecurityService.java index 3b49cedbb8..13024343f1 100644 --- a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/model/security/ModelSecurityService.java +++ b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/model/security/ModelSecurityService.java @@ -29,115 +29,117 @@ package org.alfresco.module.org_alfresco_module_rm.model.security; import java.util.Set; +import org.alfresco.api.AlfrescoPublicApi; import org.alfresco.service.cmr.repository.NodeRef; import org.alfresco.service.namespace.QName; /** * Model security service interface. - * + * * @author Roy Wetherall * @since 2.1 */ +@AlfrescoPublicApi public interface ModelSecurityService { /** * Sets whether model security is enabled globally or not. - * + * * @param enabled */ void setEnabled(boolean enabled); - + /** * Indicates whether model security is enabled or not. - * + * * @return */ boolean isEnabled(); - + /** * Disable model security checks for the current thread. */ void disable(); - + /** * Enable model security checks for the current thread. */ void enable(); - + /** * Registers a protected model artifact with the service. - * + * * @param atrifact protected model artifact */ - void register(ProtectedModelArtifact atrifact); - + void register(ProtectedModelArtifact atrifact); + /** * Indicates whether a property is protected or not. - * + * * @param name name of property * @return boolean true if property is protected, false otherwise */ boolean isProtectedProperty(QName property); - + /** * Get the protected properties - * + * * @return {@link Set}<{@link QName}> all the protected properties */ Set getProtectedProperties(); - + /** * Get the details of the protected property, returns null if property * is not protected. - * + * * @param name name of the protected property * @return {@link ProtectedProperty} protected property details, null otherwise */ ProtectedProperty getProtectedProperty(QName name); - + /** * Indicates whether the current user can edit a protected property in the context of * a given node. - *

+ *

* If the property is not protected then returns true. - * + * * @param nodeRef node reference * @param property name of the property * @return boolean true if the current user can edit the protected property or the property * is not protected, false otherwise */ boolean canEditProtectedProperty(NodeRef nodeRef, QName property); - + /** * Indicates whether an aspect is protected or not. - * + * * @param aspect aspect name * @return boolean true if aspect is protected, false otherwise */ boolean isProtectedAspect(QName aspect); - + /** * Get the protected aspects. - * + * * @return {@link Set}<{@link QName}> all the protected aspects */ - Set getProtectedAspects(); - + Set getProtectedAspects(); + /** * Get the details of the protected aspect, returns null if aspect is * not protected. - * + * * @param name name of the aspect * @return {@link ProtectedAspect} protected aspect details, null otherwise */ ProtectedAspect getProtectedAspect(QName name); - + /** - * Indicates whether the current user can edit (ie add or remove) a protected + * Indicates whether the current user can edit (ie add or remove) a protected * aspect in the context of a given node. *

* If the aspect is not protected then returns true. - * + * * @param nodeRef node reference * @param aspect name of the of aspect * @return boolean true if the current user can edit the protected aspect or the the diff --git a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/model/security/ProtectedAspect.java b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/model/security/ProtectedAspect.java index e7845667c0..96c6f5be61 100644 --- a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/model/security/ProtectedAspect.java +++ b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/model/security/ProtectedAspect.java @@ -27,10 +27,13 @@ package org.alfresco.module.org_alfresco_module_rm.model.security; +import org.alfresco.api.AlfrescoPublicApi; + /** * @author Roy Wetherall * @since 2.1 */ +@AlfrescoPublicApi public class ProtectedAspect extends ProtectedModelArtifact { diff --git a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/model/security/ProtectedModelArtifact.java b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/model/security/ProtectedModelArtifact.java index 51f591459c..ca5a74ef37 100644 --- a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/model/security/ProtectedModelArtifact.java +++ b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/model/security/ProtectedModelArtifact.java @@ -30,33 +30,35 @@ package org.alfresco.module.org_alfresco_module_rm.model.security; import java.util.HashSet; import java.util.Set; +import org.alfresco.api.AlfrescoPublicApi; import org.alfresco.module.org_alfresco_module_rm.capability.Capability; import org.alfresco.service.namespace.NamespaceService; import org.alfresco.service.namespace.QName; /** * Protected model artifact class. - * + * * @author Roy Wetherall * @since 2.1 */ +@AlfrescoPublicApi public abstract class ProtectedModelArtifact { /** Model security service */ - private ModelSecurityService modelSecurityService; - + private ModelSecurityService modelSecurityService; + /** Namespace service */ private NamespaceService namespaceService; - + /** Qualified name of the model artifact */ private QName name; - + /** Set of capabilities */ private Set capabilities; - + /** Capability names */ private Set capabilityNames; - + /** * @param namespaceService namespace service */ @@ -64,7 +66,7 @@ public abstract class ProtectedModelArtifact { this.namespaceService = namespaceService; } - + /** * @param modelSecurityService model security service */ @@ -72,7 +74,7 @@ public abstract class ProtectedModelArtifact { this.modelSecurityService = modelSecurityService; } - + /** * Init method */ @@ -80,7 +82,7 @@ public abstract class ProtectedModelArtifact { modelSecurityService.register(this); } - + /** * @param name artifact name (in cm:content form) */ @@ -89,7 +91,7 @@ public abstract class ProtectedModelArtifact QName qname = QName.createQName(name, namespaceService); this.name = qname; } - + /** * @return artifact QName */ @@ -97,7 +99,7 @@ public abstract class ProtectedModelArtifact { return name; } - + /** * @param capabilities capabilities */ @@ -105,7 +107,7 @@ public abstract class ProtectedModelArtifact { this.capabilities = capabilities; } - + /** * @return capabilities */ @@ -113,7 +115,7 @@ public abstract class ProtectedModelArtifact { return capabilities; } - + /** * @return capability names */ @@ -125,9 +127,9 @@ public abstract class ProtectedModelArtifact for (Capability capability : capabilities) { capabilityNames.add(capability.getName()); - } + } } - + return capabilityNames; } } diff --git a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/model/security/ProtectedProperty.java b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/model/security/ProtectedProperty.java index cfb0de73a4..f6844fa781 100644 --- a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/model/security/ProtectedProperty.java +++ b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/model/security/ProtectedProperty.java @@ -27,17 +27,20 @@ package org.alfresco.module.org_alfresco_module_rm.model.security; +import org.alfresco.api.AlfrescoPublicApi; + /** * Protected property implementation - * + * * @author Roy Wetherall * @since 2.1 */ +@AlfrescoPublicApi public class ProtectedProperty extends ProtectedModelArtifact { /** always allow new indicator */ private boolean allwaysAllowNew = false; - + /** * @param allwaysAllowNew true if always allow new, false otherwise */ @@ -45,7 +48,7 @@ public class ProtectedProperty extends ProtectedModelArtifact { this.allwaysAllowNew = allwaysAllowNew; } - + /** * @return true if always allow new, false otherwise */ diff --git a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/record/InplaceRecordService.java b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/record/InplaceRecordService.java index 6b181775ad..2fd45ca2ef 100644 --- a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/record/InplaceRecordService.java +++ b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/record/InplaceRecordService.java @@ -27,6 +27,7 @@ package org.alfresco.module.org_alfresco_module_rm.record; +import org.alfresco.api.AlfrescoPublicApi; import org.alfresco.service.cmr.repository.NodeRef; /** @@ -35,6 +36,7 @@ import org.alfresco.service.cmr.repository.NodeRef; * @author Tuna Aksoy * @since 2.3 */ +@AlfrescoPublicApi public interface InplaceRecordService { /** diff --git a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/record/RecordService.java b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/record/RecordService.java index 71b75cc22f..a710454e8f 100644 --- a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/record/RecordService.java +++ b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/record/RecordService.java @@ -32,6 +32,7 @@ import java.util.List; import java.util.Map; import java.util.Set; +import org.alfresco.api.AlfrescoPublicApi; import org.alfresco.service.cmr.repository.ContentReader; import org.alfresco.service.cmr.repository.NodeRef; import org.alfresco.service.namespace.QName; @@ -42,6 +43,7 @@ import org.alfresco.service.namespace.QName; * @author Roy Wetherall * @since 2.1 */ +@AlfrescoPublicApi public interface RecordService { /** @@ -62,7 +64,7 @@ public interface RecordService /** * Disables the property editable check. - * + * * @since 2.2 */ void disablePropertyEditableCheck(); @@ -71,7 +73,7 @@ public interface RecordService * Disables the property editable check for a given node in this transaction only. * * @param nodeRef node reference - * + * * @since 2.2 */ void disablePropertyEditableCheck(NodeRef nodeRef); @@ -90,26 +92,26 @@ public interface RecordService */ @Deprecated Set getRecordMetaDataAspects(); - + /** * Indicates whether the provided aspect is a registered record meta-data * aspect. - * + * * @param aspect aspect {@link QName} - * @return boolean true if the aspect is a registered record meta-data aspect, false otherwise - * + * @return boolean true if the aspect is a registered record meta-data aspect, false otherwise + * * @since 2.3 */ boolean isRecordMetadataAspect(QName aspect); - + /** - * Indicates whther the provided property is declared on a registered record + * Indicates whther the provided property is declared on a registered record * meta-data aspect. - * + * * @param property property {@link QName} - * @return boolean true if the property is declared on a registered record meta-data aspect, + * @return boolean true if the property is declared on a registered record meta-data aspect, * false otherwise - * + * * @since 2.3 */ boolean isRecordMetadataProperty(QName property); @@ -175,10 +177,10 @@ public interface RecordService * @see #createRecord(NodeRef, NodeRef, boolean) */ void createRecord(NodeRef filePlan, NodeRef nodeRef); - + /** * Creates a record from a copy of the node reference provided. - * + * * @param filePlan file plan * @param nodeRef node reference */ @@ -266,13 +268,13 @@ public interface RecordService * @param recordFolder the record folder to link it to */ void link(NodeRef record, NodeRef recordFolder); - + /** * Unlinks a record from a specified record folder. - * + * * @param record the record to unlink * @param recordFolder the record folder to unlink it from - * + * * @since 2.3 */ void unlink(NodeRef record, NodeRef recordFolder); diff --git a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/recordableversion/RecordableVersionConfigService.java b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/recordableversion/RecordableVersionConfigService.java index fcf2ffdbe6..12dfef7198 100644 --- a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/recordableversion/RecordableVersionConfigService.java +++ b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/recordableversion/RecordableVersionConfigService.java @@ -29,6 +29,7 @@ package org.alfresco.module.org_alfresco_module_rm.recordableversion; import java.util.List; +import org.alfresco.api.AlfrescoPublicApi; import org.alfresco.module.org_alfresco_module_rm.script.slingshot.Version; import org.alfresco.service.cmr.repository.NodeRef; @@ -38,6 +39,7 @@ import org.alfresco.service.cmr.repository.NodeRef; * @author Tuna Aksoy * @since 2.3 */ +@AlfrescoPublicApi public interface RecordableVersionConfigService { /** diff --git a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/recordfolder/RecordFolderService.java b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/recordfolder/RecordFolderService.java index b58e1dadf2..3e93b32ffe 100644 --- a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/recordfolder/RecordFolderService.java +++ b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/recordfolder/RecordFolderService.java @@ -31,6 +31,7 @@ import java.io.Serializable; import java.util.List; import java.util.Map; +import org.alfresco.api.AlfrescoPublicApi; import org.alfresco.service.cmr.repository.NodeRef; import org.alfresco.service.namespace.QName; @@ -40,6 +41,7 @@ import org.alfresco.service.namespace.QName; * @author Roy Wetherall * @since 2.1 */ +@AlfrescoPublicApi public interface RecordFolderService { /** diff --git a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/relationship/Relationship.java b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/relationship/Relationship.java index 97a7b5dab4..09048f4cd2 100644 --- a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/relationship/Relationship.java +++ b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/relationship/Relationship.java @@ -27,6 +27,7 @@ package org.alfresco.module.org_alfresco_module_rm.relationship; +import org.alfresco.api.AlfrescoPublicApi; import org.alfresco.service.cmr.repository.NodeRef; /** @@ -35,6 +36,7 @@ import org.alfresco.service.cmr.repository.NodeRef; * @author Tuna Aksoy * @since 2.3 */ +@AlfrescoPublicApi public interface Relationship { /** diff --git a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/relationship/RelationshipDefinition.java b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/relationship/RelationshipDefinition.java index 039fef1f0f..2493664b3e 100644 --- a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/relationship/RelationshipDefinition.java +++ b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/relationship/RelationshipDefinition.java @@ -27,12 +27,15 @@ package org.alfresco.module.org_alfresco_module_rm.relationship; +import org.alfresco.api.AlfrescoPublicApi; + /** * Interface representing the relationship definition * * @author Tuna Aksoy * @since 2.3 */ +@AlfrescoPublicApi public interface RelationshipDefinition { /** diff --git a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/relationship/RelationshipDisplayName.java b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/relationship/RelationshipDisplayName.java index f958a39217..59be1f4983 100644 --- a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/relationship/RelationshipDisplayName.java +++ b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/relationship/RelationshipDisplayName.java @@ -29,12 +29,15 @@ package org.alfresco.module.org_alfresco_module_rm.relationship; import static org.alfresco.util.ParameterCheck.mandatoryString; +import org.alfresco.api.AlfrescoPublicApi; + /** * POJO representing the relationship display name * * @author Tuna Aksoy * @since 2.3 */ +@AlfrescoPublicApi public class RelationshipDisplayName { /** The source text of the relationship */ diff --git a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/relationship/RelationshipService.java b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/relationship/RelationshipService.java index eb96198656..e8500f49c9 100644 --- a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/relationship/RelationshipService.java +++ b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/relationship/RelationshipService.java @@ -29,6 +29,7 @@ package org.alfresco.module.org_alfresco_module_rm.relationship; import java.util.Set; +import org.alfresco.api.AlfrescoPublicApi; import org.alfresco.service.cmr.repository.NodeRef; /** @@ -37,11 +38,12 @@ import org.alfresco.service.cmr.repository.NodeRef; * @author Tuna Aksoy * @since 2.3 */ +@AlfrescoPublicApi public interface RelationshipService { /** System relationship names */ static final String RELATIONSHIP_VERSIONS = "versions"; - + /** * Gets all the existing relationship definitions * @@ -97,7 +99,7 @@ public interface RelationshipService * @return All relationships that come out from the given node reference */ Set getRelationshipsFrom(NodeRef nodeRef); - + /** * Gets all the relationships that come out from the given node reference * that match the a given name filter. @@ -107,7 +109,7 @@ public interface RelationshipService * @param nodeRef The node reference * @param nameFilter Name filter for results * @return All relationships that come out from the given node reference - * + * * @since 2.3.1 */ Set getRelationshipsFrom(NodeRef nodeRef, String nameFilter); @@ -119,7 +121,7 @@ public interface RelationshipService * @return All relationships that go into the given node reference */ Set getRelationshipsTo(NodeRef nodeRef); - + /** * Gets all the relationships that go into the given node reference * that match the a given name filter. @@ -129,7 +131,7 @@ public interface RelationshipService * @param nodeRef The node reference * @param nameFilter Name filter for results * @return All relationships that go into the given node reference - * + * * @since 2.3.1 */ Set getRelationshipsTo(NodeRef nodeRef, String nameFilter); diff --git a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/relationship/RelationshipType.java b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/relationship/RelationshipType.java index 0896c83806..b1e8201489 100644 --- a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/relationship/RelationshipType.java +++ b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/relationship/RelationshipType.java @@ -27,12 +27,15 @@ package org.alfresco.module.org_alfresco_module_rm.relationship; +import org.alfresco.api.AlfrescoPublicApi; + /** * Enum representing the relationship types * * @author Tuna Aksoy * @since 2.3 */ +@AlfrescoPublicApi public enum RelationshipType { BIDIRECTIONAL, diff --git a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/report/Report.java b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/report/Report.java index fb4b52b819..e98a1c2819 100644 --- a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/report/Report.java +++ b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/report/Report.java @@ -30,32 +30,34 @@ package org.alfresco.module.org_alfresco_module_rm.report; import java.io.Serializable; import java.util.Map; +import org.alfresco.api.AlfrescoPublicApi; import org.alfresco.service.cmr.repository.ContentReader; import org.alfresco.service.namespace.QName; /** * Report interface. - * + * * @author Roy Wetherall * @since 2.1 */ +@AlfrescoPublicApi public interface Report { /** * @return {@link QName} report type */ QName getReportType(); - + /** * @return {@link String} report name */ String getReportName(); - + /** * @return {@link Map}<{@link QName},{@link Serializable}> report properties */ Map getReportProperties(); - + /** * @return {@link ContentReader} content reader to report content */ diff --git a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/report/ReportGenerator.java b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/report/ReportGenerator.java index a91d6afdab..2d9ab07d76 100644 --- a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/report/ReportGenerator.java +++ b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/report/ReportGenerator.java @@ -27,15 +27,17 @@ package org.alfresco.module.org_alfresco_module_rm.report; +import org.alfresco.api.AlfrescoPublicApi; import org.alfresco.service.cmr.repository.NodeRef; import org.alfresco.service.namespace.QName; /** * Report generator interface. - * + * * @author Roy Wetherall * @since 2.1 */ +@AlfrescoPublicApi public interface ReportGenerator { /** @@ -45,7 +47,7 @@ public interface ReportGenerator /** * Generate report. - * + * * @param reportedUponNodeRef * @param mimetype * @return diff --git a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/report/ReportService.java b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/report/ReportService.java index 1a88c54990..3fcc6afbf4 100644 --- a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/report/ReportService.java +++ b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/report/ReportService.java @@ -29,6 +29,7 @@ package org.alfresco.module.org_alfresco_module_rm.report; import java.util.Set; +import org.alfresco.api.AlfrescoPublicApi; import org.alfresco.service.cmr.repository.NodeRef; import org.alfresco.service.namespace.QName; @@ -38,6 +39,7 @@ import org.alfresco.service.namespace.QName; * @author Roy Wetherall * @since 2.1 */ +@AlfrescoPublicApi public interface ReportService { /** @@ -65,7 +67,7 @@ public interface ReportService /** * Generate a report for a specified mimetype. - * + * * @see #generateReport(QName, NodeRef) * * @param reportType report type diff --git a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/role/FilePlanRoleService.java b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/role/FilePlanRoleService.java index e809cd79e3..3ae284f404 100644 --- a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/role/FilePlanRoleService.java +++ b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/role/FilePlanRoleService.java @@ -31,6 +31,7 @@ import java.util.Arrays; import java.util.List; import java.util.Set; +import org.alfresco.api.AlfrescoPublicApi; import org.alfresco.module.org_alfresco_module_rm.capability.Capability; import org.alfresco.service.cmr.repository.NodeRef; @@ -40,12 +41,13 @@ import org.alfresco.service.cmr.repository.NodeRef; * @author Roy Wetherall * @since 2.1 */ +@AlfrescoPublicApi public interface FilePlanRoleService { /** Default role names */ String ROLE_USER = "User"; String ROLE_POWER_USER = "PowerUser"; - String ROLE_SECURITY_OFFICER = "SecurityOfficer"; + String ROLE_SECURITY_OFFICER = "SecurityOfficer"; String ROLE_RECORDS_MANAGER = "RecordsManager"; String ROLE_ADMIN = "Administrator"; String ROLE_EXTENDED_READERS = "ExtendedReaders"; diff --git a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/role/Role.java b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/role/Role.java index 3957fc98aa..07ff98bbd0 100644 --- a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/role/Role.java +++ b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/role/Role.java @@ -29,6 +29,7 @@ package org.alfresco.module.org_alfresco_module_rm.role; import java.util.Set; +import org.alfresco.api.AlfrescoPublicApi; import org.alfresco.module.org_alfresco_module_rm.capability.Capability; /** @@ -36,6 +37,7 @@ import org.alfresco.module.org_alfresco_module_rm.capability.Capability; * * @author Roy Wetherall */ +@AlfrescoPublicApi public class Role { /** Role name */ diff --git a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/search/RecordsManagementSearchParameters.java b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/search/RecordsManagementSearchParameters.java index dbaeff26b2..427832a366 100644 --- a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/search/RecordsManagementSearchParameters.java +++ b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/search/RecordsManagementSearchParameters.java @@ -33,6 +33,7 @@ import java.util.HashMap; import java.util.List; import java.util.Map; +import org.alfresco.api.AlfrescoPublicApi; import org.alfresco.error.AlfrescoRuntimeException; import org.alfresco.model.ContentModel; import org.alfresco.service.cmr.repository.datatype.DefaultTypeConverter; @@ -48,6 +49,7 @@ import org.json.JSONObject; /** * @author Roy Wetherall */ +@AlfrescoPublicApi @SuppressWarnings("serial") public class RecordsManagementSearchParameters { diff --git a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/search/RecordsManagementSearchService.java b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/search/RecordsManagementSearchService.java index 679f137208..fda7dff57b 100644 --- a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/search/RecordsManagementSearchService.java +++ b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/search/RecordsManagementSearchService.java @@ -29,71 +29,73 @@ package org.alfresco.module.org_alfresco_module_rm.search; import java.util.List; +import org.alfresco.api.AlfrescoPublicApi; import org.alfresco.service.cmr.repository.NodeRef; import org.alfresco.util.Pair; /** * Records management search service. - * + * * @author Roy Wetherall */ -public interface RecordsManagementSearchService -{ +@AlfrescoPublicApi +public interface RecordsManagementSearchService +{ /** * Execute a records management search * @param siteId the id of the rm site to query * @param query search query string - * @param searchParameters search parameters - * @return {@link List}<{@link Pair}<{@link NodeRef}, {@link NodeRef}> search results as pairs for parent and child nodes + * @param searchParameters search parameters + * @return {@link List}<{@link Pair}<{@link NodeRef}, {@link NodeRef}> search results as pairs for parent and child nodes */ - List> search(String siteId, String query, RecordsManagementSearchParameters searchParameters); - + List> search(String siteId, String query, RecordsManagementSearchParameters searchParameters); + /** * Get all the searches saved on the given records management site. * @param siteId site id - * @return {@link List<{@link SavedSearchDetails}>} list of saved search details + * @return {@link List<{@link SavedSearchDetails}>} list of saved search details */ List getSavedSearches(String siteId); - + /** - * Get a named saved search for a given records management site. + * Get a named saved search for a given records management site. * @param siteId site id * @param name name of search * @return {@link SavedSearchDetails} saved search details */ SavedSearchDetails getSavedSearch(String siteId, String name); - + /** * Save records management search. * @param siteId site id - * @param name name - * @param description description - * @param search search string + * @param name name + * @param description description + * @param search search string * @param isPublic indicates whether the saved search is public or not * @return {@link SavedSearchDetails} details of the saved search */ SavedSearchDetails saveSearch(String siteId, String name, String description, String search, RecordsManagementSearchParameters searchParameters, boolean isPublic); - + /** * Save records management search. * @param savedSearchDetails details of search to save * @return {@link SavedSearchDetails} details of the saved search */ SavedSearchDetails saveSearch(SavedSearchDetails savedSearchDetails); - + /** * Delete saved search * @param siteId site id * @param name name of saved search */ void deleteSavedSearch(String siteId, String name); - + /** * Delete saved search * @param savedSearchDetails saved search details */ void deleteSavedSearch(SavedSearchDetails savedSearchDetails); - + /** * Adds the reports as saved searches to a given site. * @param siteId site id diff --git a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/search/RecordsManagementSearchServiceImpl.java b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/search/RecordsManagementSearchServiceImpl.java index 900b25b474..a9fc922dca 100644 --- a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/search/RecordsManagementSearchServiceImpl.java +++ b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/search/RecordsManagementSearchServiceImpl.java @@ -31,6 +31,7 @@ import java.util.ArrayList; import java.util.List; import java.util.Map.Entry; +import org.alfresco.api.AlfrescoPublicApi; import org.alfresco.error.AlfrescoRuntimeException; import org.alfresco.model.ContentModel; import org.alfresco.module.org_alfresco_module_rm.model.RecordsManagementModel; @@ -63,6 +64,7 @@ import org.springframework.extensions.surf.util.I18NUtil; * * @author Roy Wetherall */ +@AlfrescoPublicApi public class RecordsManagementSearchServiceImpl implements RecordsManagementSearchService { private static final String SITES_SPACE_QNAME_PATH = "/app:company_home/st:sites/"; @@ -214,12 +216,12 @@ public class RecordsManagementSearchServiceImpl implements RecordsManagementSear // execute query ResultSet resultSet = searchService.query(searchParameters); - + // process results List> result = new ArrayList>(resultSet.length()); for (ChildAssociationRef childAssoc : resultSet.getChildAssocRefs()) { - result.add(new Pair(childAssoc.getParentRef(), childAssoc.getChildRef())); + result.add(new Pair(childAssoc.getParentRef(), childAssoc.getChildRef())); } // return results diff --git a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/search/SavedSearchDetails.java b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/search/SavedSearchDetails.java index 2760a7cfa0..bbe4bc3855 100644 --- a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/search/SavedSearchDetails.java +++ b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/search/SavedSearchDetails.java @@ -27,6 +27,7 @@ package org.alfresco.module.org_alfresco_module_rm.search; +import org.alfresco.api.AlfrescoPublicApi; import org.alfresco.error.AlfrescoRuntimeException; import org.alfresco.service.cmr.repository.NodeRef; import org.alfresco.service.namespace.NamespaceService; @@ -83,6 +84,7 @@ import org.springframework.extensions.surf.util.I18NUtil; * * @author Roy Wetherall */ +@AlfrescoPublicApi public class SavedSearchDetails extends ReportDetails { // JSON label values diff --git a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/search/SavedSearchDetailsCompatibility.java b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/search/SavedSearchDetailsCompatibility.java index 9fb1cd64a8..30370ca94e 100644 --- a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/search/SavedSearchDetailsCompatibility.java +++ b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/search/SavedSearchDetailsCompatibility.java @@ -32,6 +32,7 @@ import java.net.URLDecoder; import java.util.ArrayList; import java.util.List; +import org.alfresco.api.AlfrescoPublicApi; import org.alfresco.module.org_alfresco_module_rm.model.RecordsManagementModel; import org.alfresco.service.namespace.NamespaceService; import org.alfresco.service.namespace.QName; @@ -42,6 +43,7 @@ import org.alfresco.service.namespace.QName; * Used to bridge between the old style of saved search passed and required by the UI and the new actual saved search details. * Eventually will be factored out as web scripts are brought up to date. */ +@AlfrescoPublicApi public class SavedSearchDetailsCompatibility implements RecordsManagementModel { /** Saved search details */ diff --git a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/security/ExtendedSecurityService.java b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/security/ExtendedSecurityService.java index 6c3af1a400..1f4742f669 100644 --- a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/security/ExtendedSecurityService.java +++ b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/security/ExtendedSecurityService.java @@ -29,35 +29,37 @@ package org.alfresco.module.org_alfresco_module_rm.security; import java.util.Set; +import org.alfresco.api.AlfrescoPublicApi; import org.alfresco.service.cmr.repository.NodeRef; /** * Extended security service. - * + * * @author Roy Wetherall * @since 2.1 */ +@AlfrescoPublicApi public interface ExtendedSecurityService { /** * Indicates whether a node has extended security. - * + * * @param nodeRef node reference * @return boolean true if the node has extedned security, false otherwise */ boolean hasExtendedSecurity(NodeRef nodeRef); - + /** * Gets the set of authorities that are extended readers for the given node. - * + * * @param nodeRef node reference * @return {@link Set}<{@link String}> set of extended readers */ Set getExtendedReaders(NodeRef nodeRef); - + /** * Get the set of authorities that are extended writers for the given node. - * + * * @param nodeRef node reference * @return {@link Set}<{@link String}> set of extended writers */ @@ -65,42 +67,42 @@ public interface ExtendedSecurityService /** * Add extended security for the specified authorities to a node. - * + * * @param nodeRef node reference * @param readers set of authorities to add extended read permissions * @param writers set of authorities to add extended write permissions */ void addExtendedSecurity(NodeRef nodeRef, Set readers, Set writers); - + /** * Add extended security for the specified authorities to a node. *

- * If specified, the read and write extended permissions are applied to all parents up to the file plan as + * If specified, the read and write extended permissions are applied to all parents up to the file plan as * extended read. This ensures parental read, but not parental write. - * + * * @param nodeRef node reference * @param readers set of authorities to add extended read permissions * @param writers set of authorities to add extended write permissions * @param applyToParents true if extended security applied to parents (read only) false otherwise. */ void addExtendedSecurity(NodeRef nodeRef, Set readers, Set writers, boolean applyToParents); - + /** * Remove the extended security for the specified authorities from a node. - * + * * @param nodeRef node reference * @param readers set of authorities to remove as extended readers * @param writers set of authorities to remove as extended writers */ void removeExtendedSecurity(NodeRef nodeRef, Set readers, Set writers); - + /** * Remove the extended security for the specified authorities from a node. *

- * If specified, extended security will also be removed from the parent hierarchy.(read only). Note that + * If specified, extended security will also be removed from the parent hierarchy.(read only). Note that * extended security is records as a reference count, so security will only be utterly removed from the parent * hierarchy if all references to the authority are removed. - * + * * @param nodeRef node reference * @param readers set of authorities to remove as extended readers * @param writers set of authorities to remove as extedned writers @@ -108,17 +110,17 @@ public interface ExtendedSecurityService * otherwise */ void removeExtendedSecurity(NodeRef nodeRef, Set readers, Set writers, boolean applyToParents); - + /** * Remove all extended readers and writers from the given node reference. - * + * * @param nodeRef node reference */ void removeAllExtendedSecurity(NodeRef nodeRef); - + /** * Remove all extended readers and writers from the given node reference. - * + * * @param nodeRef node reference * @param applyToParents if true then apply removal to parent hierarchy (read only) false otherwise. */ diff --git a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/security/FilePlanAuthenticationService.java b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/security/FilePlanAuthenticationService.java index a2737bdc79..af9f9f22ed 100644 --- a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/security/FilePlanAuthenticationService.java +++ b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/security/FilePlanAuthenticationService.java @@ -35,6 +35,7 @@ import org.alfresco.repo.security.authentication.AuthenticationUtil.RunAsWork; * * @author Roy Wetherall * @since 2.1 + * @deprecated as of 2.2, use {@link AuthenticationUtil}. */ public interface FilePlanAuthenticationService { diff --git a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/security/FilePlanPermissionService.java b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/security/FilePlanPermissionService.java index 5dafce4a83..69c3006bcd 100644 --- a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/security/FilePlanPermissionService.java +++ b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/security/FilePlanPermissionService.java @@ -27,46 +27,48 @@ package org.alfresco.module.org_alfresco_module_rm.security; +import org.alfresco.api.AlfrescoPublicApi; import org.alfresco.service.cmr.repository.NodeRef; /** * File plan permission service. - * + * * @author Roy Wetherall * @since 2.1 */ +@AlfrescoPublicApi public interface FilePlanPermissionService { /** * Setup permissions for a record category - * + * * @param nodeRef record category node reference */ void setupRecordCategoryPermissions(NodeRef recordCategory); - + /** * Setup permissions for an object within a given parent. - * + * * @param parent parent node to inherit permissions from - * @param nodeRef node ref to setup permissions on + * @param nodeRef node ref to setup permissions on */ void setupPermissions(NodeRef parent, NodeRef nodeRef); - + /** - * Sets a permission on a file plan object. Assumes allow is true. Cascades permission down to record folder. + * Sets a permission on a file plan object. Assumes allow is true. Cascades permission down to record folder. * Cascades ReadRecord up to file plan. - * + * * @param nodeRef node reference - * @param authority authority + * @param authority authority * @param permission permission */ void setPermission(NodeRef nodeRef, String authority, String permission); - + /** * Deletes a permission from a file plan object. Cascades removal down to record folder. - * + * * @param nodeRef node reference - * @param authority authority + * @param authority authority * @param permission permission */ void deletePermission(NodeRef nodeRef, String authority, String permission); diff --git a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/transfer/TransferService.java b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/transfer/TransferService.java index 84484e4376..ea9fdd3253 100644 --- a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/transfer/TransferService.java +++ b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/transfer/TransferService.java @@ -27,6 +27,7 @@ package org.alfresco.module.org_alfresco_module_rm.transfer; +import org.alfresco.api.AlfrescoPublicApi; import org.alfresco.service.cmr.repository.NodeRef; /** @@ -35,6 +36,7 @@ import org.alfresco.service.cmr.repository.NodeRef; * @author Tuna Aksoy * @since 2.2 */ +@AlfrescoPublicApi public interface TransferService { /** @@ -62,7 +64,7 @@ public interface TransferService * Completes the transfer for the given node. * * @param nodeRef node reference to complete the transfer - * + * * @since 2.2 */ void completeTransfer(NodeRef nodeRef); diff --git a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/util/AuthenticationUtil.java b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/util/AuthenticationUtil.java index c7f2c4a3dd..843cb0db09 100644 --- a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/util/AuthenticationUtil.java +++ b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/util/AuthenticationUtil.java @@ -27,6 +27,7 @@ package org.alfresco.module.org_alfresco_module_rm.util; +import org.alfresco.api.AlfrescoPublicApi; import org.alfresco.repo.security.authentication.AuthenticationException; import org.alfresco.repo.security.authentication.AuthenticationUtil.RunAsWork; @@ -38,6 +39,7 @@ import org.alfresco.repo.security.authentication.AuthenticationUtil.RunAsWork; * @author Roy Wetherall * @since 2.3 */ +@AlfrescoPublicApi public class AuthenticationUtil { /** diff --git a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/util/ServiceBaseImpl.java b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/util/ServiceBaseImpl.java index 904a592d96..c56fad63b1 100644 --- a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/util/ServiceBaseImpl.java +++ b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/util/ServiceBaseImpl.java @@ -31,6 +31,7 @@ import java.util.Map; import java.util.Set; import java.util.WeakHashMap; +import org.alfresco.api.AlfrescoPublicApi; import org.alfresco.module.org_alfresco_module_rm.fileplan.FilePlanComponentKind; import org.alfresco.module.org_alfresco_module_rm.fileplan.FilePlanService; import org.alfresco.module.org_alfresco_module_rm.hold.HoldService; @@ -52,6 +53,7 @@ import org.springframework.context.ApplicationContextAware; * @author Roy Wetherall * @since 2.1 */ +@AlfrescoPublicApi public class ServiceBaseImpl implements RecordsManagementModel, ApplicationContextAware { /** Node service */ @@ -71,9 +73,9 @@ public class ServiceBaseImpl implements RecordsManagementModel, ApplicationConte /** authentication helper */ protected AuthenticationUtil authenticationUtil; - + /** transactional resource helper */ - protected TransactionalResourceHelper transactionalResourceHelper; + protected TransactionalResourceHelper transactionalResourceHelper; /** * @see org.springframework.context.ApplicationContextAware#setApplicationContext(org.springframework.context.ApplicationContext) @@ -115,7 +117,7 @@ public class ServiceBaseImpl implements RecordsManagementModel, ApplicationConte { this.authenticationUtil = authenticationUtil; } - + /** * @param transactionalResourceHelper transactional resource helper */ diff --git a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/util/TransactionalResourceHelper.java b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/util/TransactionalResourceHelper.java index b9465e221c..0d66472b07 100644 --- a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/util/TransactionalResourceHelper.java +++ b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/util/TransactionalResourceHelper.java @@ -32,13 +32,16 @@ import java.util.Map; import java.util.Set; import java.util.TreeSet; +import org.alfresco.api.AlfrescoPublicApi; + /** * Delegate spring bean for TransactionResourceHelper - * + * * @author Roy Wetherall * @since 2.3 * @see org.alfresco.repo.transaction.TransactionalResourceHelper */ +@AlfrescoPublicApi public class TransactionalResourceHelper { /** @@ -48,7 +51,7 @@ public class TransactionalResourceHelper { return org.alfresco.repo.transaction.TransactionalResourceHelper.getCount(resourceKey); } - + /** * @see org.alfresco.repo.transaction.TransactionalResourceHelper#getCount(Object) */ @@ -56,7 +59,7 @@ public class TransactionalResourceHelper { org.alfresco.repo.transaction.TransactionalResourceHelper.resetCount(resourceKey); } - + /** * @see org.alfresco.repo.transaction.TransactionalResourceHelper#incrementCount(Object) */ @@ -64,7 +67,7 @@ public class TransactionalResourceHelper { return org.alfresco.repo.transaction.TransactionalResourceHelper.incrementCount(resourceKey); } - + /** * @see org.alfresco.repo.transaction.TransactionalResourceHelper#decrementCount(Object, boolean) */ @@ -72,7 +75,7 @@ public class TransactionalResourceHelper { return org.alfresco.repo.transaction.TransactionalResourceHelper.decrementCount(resourceKey, allowNegative); } - + /** * @see org.alfresco.repo.transaction.TransactionalResourceHelper#getCount(Object) */ @@ -80,7 +83,7 @@ public class TransactionalResourceHelper { return org.alfresco.repo.transaction.TransactionalResourceHelper.isResourcePresent(resourceKey); } - + /** * @see org.alfresco.repo.transaction.TransactionalResourceHelper#getMap(Object) */ diff --git a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/version/RecordableVersionService.java b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/version/RecordableVersionService.java index 3097d96727..6230411094 100644 --- a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/version/RecordableVersionService.java +++ b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/version/RecordableVersionService.java @@ -27,77 +27,79 @@ package org.alfresco.module.org_alfresco_module_rm.version; +import org.alfresco.api.AlfrescoPublicApi; import org.alfresco.service.cmr.repository.NodeRef; import org.alfresco.service.cmr.version.Version; /** * Recordable version service interface. - * + * * @author Roy Wetherall * @since 2.3 */ -public interface RecordableVersionService +@AlfrescoPublicApi +public interface RecordableVersionService { /** * Indicates whether the current version of a node is recorded or not. *

* Returns false if not versionable or no version. - * + * * @param nodeRef node reference * @return boolean true if latest version recorded, false otherwise */ boolean isCurrentVersionRecorded(NodeRef nodeRef); - + /** * Indicates whether a version is recorded or not. - * + * * @param version version * @return boolean true if recorded version, false otherwise */ boolean isRecordedVersion(Version version); - + /** - * If the version is a recorded version, gets the related version + * If the version is a recorded version, gets the related version * record. - * + * * @param version version * @return NodeRef node reference of version record */ NodeRef getVersionRecord(Version version); - + /** * Gets the version that relates to the version record - * + * * @param versionRecord version record node reference * @return Version version or null if not found */ Version getRecordedVersion(NodeRef record); - + /** * Creates a record from the latest version, marking it as recorded. *

* Does not create a record if the node is not versionable or the latest * version is already recorded. - * + * * @param nodeRef node reference * @return NodeRef node reference to the created record. */ NodeRef createRecordFromLatestVersion(NodeRef filePlan, NodeRef nodeRef); - + /** * Indicates whether a record version is destroyed or not. - * + * * @param version version * @return boolean true if destroyed, false otherwise */ boolean isRecordedVersionDestroyed(Version version); - + /** * Marks a recorded version as destroyed. *

- * Note this method does not destroy the associated record, instead it marks the + * Note this method does not destroy the associated record, instead it marks the * version as destroyed. - * + * * @param version version */ void destroyRecordedVersion(Version version); diff --git a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/vital/VitalRecordService.java b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/vital/VitalRecordService.java index 339cc844c2..a5fd7c5702 100644 --- a/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/vital/VitalRecordService.java +++ b/rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/vital/VitalRecordService.java @@ -36,6 +36,7 @@ import org.alfresco.service.cmr.repository.Period; * @author Roy Wetherall * @since 2.0 */ +// Not @AlfrescoPublicApi due to e.g. Period. public interface VitalRecordService { /** Period 'none' */ diff --git a/rm-community/rm-community-repo/source/java/org/alfresco/util/SortDirection.java b/rm-community/rm-community-repo/source/java/org/alfresco/util/SortDirection.java index 688e581671..f7b6f0f728 100644 --- a/rm-community/rm-community-repo/source/java/org/alfresco/util/SortDirection.java +++ b/rm-community/rm-community-repo/source/java/org/alfresco/util/SortDirection.java @@ -1,5 +1,7 @@ package org.alfresco.util; +import org.alfresco.api.AlfrescoPublicApi; + /* * #%L * Alfresco Records Management Module @@ -35,6 +37,7 @@ import org.alfresco.error.AlfrescoRuntimeException; * @author Tuna Aksoy * @since 2.5 */ +@AlfrescoPublicApi public enum SortDirection { ASC ("asc"),