RM-2812 Mark public API methods with @AlfrescoPublicAPI.

rm-community/rm-community-repo/source/compatibility/org/alfresco/module/org_alfresco_module_rm/audit/RecordsManagementAuditServiceDeprecated.java

@@ -39,6 +39,7 @@ import org.alfresco.service.cmr.repository.NodeRef;
  *
  * @author Roy Wetherall
  * @since 2.1
+ * @deprecated as of 2.1, see {@link RecordsManagementAuditService}.
  */
 public interface RecordsManagementAuditServiceDeprecated
 {

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();

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;

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

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
 {
     /**

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
 {
     /**

rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/action/RecordsManagementActionConditionDefinition.java

@@ -27,6 +27,7 @@
 
 package org.alfresco.module.org_alfresco_module_rm.action;
 
+import org.alfresco.api.AlfrescoPublicApi;
 import org.alfresco.service.cmr.action.ActionConditionDefinition;
 
 /**
@@ -37,6 +38,7 @@ import org.alfresco.service.cmr.action.ActionConditionDefinition;
  * @author Roy Wetherall
  * @since 2.1
  */
+@AlfrescoPublicApi
 public interface RecordsManagementActionConditionDefinition extends ActionConditionDefinition
 {
 }

rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/action/RecordsManagementActionDefinition.java

@@ -29,6 +29,7 @@ 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;
 
@@ -38,6 +39,7 @@ import org.alfresco.service.cmr.action.ActionDefinition;
  * @author Roy Wetherall
  * @since 2.1
  */
+@AlfrescoPublicApi
 public interface RecordsManagementActionDefinition extends ActionDefinition
 {
     /**

rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/action/RecordsManagementActionResult.java

@@ -27,11 +27,14 @@
 
 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 */

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
 {
     /**

rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/admin/CustomMetadataException.java

@@ -27,6 +27,8 @@
 
 package org.alfresco.module.org_alfresco_module_rm.admin;
 
+import org.alfresco.api.AlfrescoPublicApi;
+
 /**
  * Custom metadata exception.
  *
@@ -34,6 +36,7 @@ package org.alfresco.module.org_alfresco_module_rm.admin;
  * @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;

rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/admin/PropertyAlreadyExistsMetadataException.java

@@ -27,6 +27,7 @@
 
 package org.alfresco.module.org_alfresco_module_rm.admin;
 
+import org.alfresco.api.AlfrescoPublicApi;
 import org.springframework.extensions.surf.util.I18NUtil;
 
 /**
@@ -36,6 +37,7 @@ import org.springframework.extensions.surf.util.I18NUtil;
  * @since 2.1
  * @see org.alfresco.module.org_alfresco_module_rm.PropertyAlreadyExistsMetadataException
  */
+@AlfrescoPublicApi
 public class PropertyAlreadyExistsMetadataException extends CustomMetadataException
 {
     private static final long serialVersionUID = -6194867814140009959L;

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
 {
     /**

rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/audit/RecordsManagementAuditService.java

@@ -42,6 +42,8 @@ import org.alfresco.service.namespace.QName;
  *
  * @author Gavin Cornwell
  */
+// Not @AlfrescoPublicApi as extends the deprecated class RecordsManagementAuditServiceDeprecated.
+@SuppressWarnings("deprecation")
 public interface RecordsManagementAuditService extends RecordsManagementAuditServiceDeprecated
 {
     public enum ReportFormat { HTML, JSON }

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
 {
     /**

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
 {
    /**

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
 {
     /**

rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/dataset/DataSet.java

@@ -27,6 +27,9 @@
 
 package org.alfresco.module.org_alfresco_module_rm.dataset;
 
+import org.alfresco.api.AlfrescoPublicApi;
+
+@AlfrescoPublicApi
 public interface DataSet
 {
 

rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/dataset/DataSetService.java

@@ -29,8 +29,10 @@ 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
 {
 

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;
@@ -39,6 +40,7 @@ import org.alfresco.service.namespace.QName;
  *
  * @author Roy Wetherall
  */
+// Not @AlfrescoPublicApi because it depends on Period which is not part of the public API.
 public interface DispositionActionDefinition
 {
     /**

rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/disposition/DispositionSchedule.java

@@ -36,6 +36,7 @@ import org.alfresco.service.cmr.repository.NodeRef;
  *
  * @author Roy Wetherall
  */
+// Not @AlfrescoPublicApi because it depends on DispositionActionDefinition which is not part of the public API.
 public interface DispositionSchedule
 {
     /**

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 ========= */

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

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
 {
     /**

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;

rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/event/RecordsManagementEvent.java

@@ -27,6 +27,7 @@
 
 package org.alfresco.module.org_alfresco_module_rm.event;
 
+import org.alfresco.api.AlfrescoPublicApi;
 import org.alfresco.util.ParameterCheck;
 
 /**
@@ -35,6 +36,7 @@ import org.alfresco.util.ParameterCheck;
  * @author Roy Wetherall
  * @since 1.0
  */
+@AlfrescoPublicApi
 public class RecordsManagementEvent
 {
     /** Records management event type */

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
 {
     /**

rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/event/RecordsManagementEventType.java

@@ -27,11 +27,14 @@
 
 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
 {
     /**

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.
  * <br>
@@ -35,6 +37,7 @@ package org.alfresco.module.org_alfresco_module_rm.fileplan;
  *
  * @author Roy Wetherall
  */
+@AlfrescoPublicApi
 public enum FilePlanComponentKind
 {
     FILE_PLAN_COMPONENT,

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
 {
     /**

rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/freeze/FreezeService.java

@@ -30,6 +30,7 @@ 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;
 
@@ -41,6 +42,7 @@ import org.alfresco.service.cmr.repository.NodeRef;
  * @author Roy Wetherall
  * @since 2.0
  */
+@AlfrescoPublicApi
 public interface FreezeService
 {
     /**

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
 {
     /**

rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/identifier/IdentifierGenerator.java

@@ -30,6 +30,7 @@ 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;
 
 /**
@@ -37,6 +38,7 @@ import org.alfresco.service.namespace.QName;
  *
  * @author Roy Wetherall
  */
+@AlfrescoPublicApi
 public interface IdentifierGenerator
 {
     /**

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 */

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

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

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

rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/model/security/ModelSecurityService.java

@@ -29,6 +29,7 @@ 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;
 
@@ -38,6 +39,7 @@ import org.alfresco.service.namespace.QName;
  * @author Roy Wetherall
  * @since 2.1
  */
+@AlfrescoPublicApi
 public interface ModelSecurityService
 {
     /**

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
 {
 

rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/model/security/ProtectedModelArtifact.java

@@ -30,6 +30,7 @@ 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;
@@ -40,6 +41,7 @@ import org.alfresco.service.namespace.QName;
  * @author Roy Wetherall
  * @since 2.1
  */
+@AlfrescoPublicApi
 public abstract class ProtectedModelArtifact
 {
     /** Model security service */

rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/model/security/ProtectedProperty.java

@@ -27,12 +27,15 @@
 
 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 */

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
 {
     /**

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
 {
     /**

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
 {
     /**

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
 {
     /**

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
 {
     /**

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
 {
     /**

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 */

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,6 +38,7 @@ import org.alfresco.service.cmr.repository.NodeRef;
  * @author Tuna Aksoy
  * @since 2.3
  */
+@AlfrescoPublicApi
 public interface RelationshipService
 {
     /** System relationship names */

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,

rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/report/Report.java

@@ -30,6 +30,7 @@ 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;
 
@@ -39,6 +40,7 @@ import org.alfresco.service.namespace.QName;
  * @author Roy Wetherall
  * @since 2.1
  */
+@AlfrescoPublicApi
 public interface Report
 {
     /**

rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/report/ReportGenerator.java

@@ -27,6 +27,7 @@
 
 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;
 
@@ -36,6 +37,7 @@ import org.alfresco.service.namespace.QName;
  * @author Roy Wetherall
  * @since 2.1
  */
+@AlfrescoPublicApi
 public interface ReportGenerator
 {
     /**

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
 {
     /**

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,6 +41,7 @@ import org.alfresco.service.cmr.repository.NodeRef;
  * @author Roy Wetherall
  * @since 2.1
  */
+@AlfrescoPublicApi
 public interface FilePlanRoleService
 {
     /** Default role names */

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 */

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
 {

rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/search/RecordsManagementSearchService.java

@@ -29,6 +29,7 @@ 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;
 
@@ -37,6 +38,7 @@ import org.alfresco.util.Pair;
  *
  * @author Roy Wetherall
  */
+@AlfrescoPublicApi
 public interface RecordsManagementSearchService
 {
 	/**

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/";

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

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 */

rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/security/ExtendedSecurityService.java

@@ -29,6 +29,7 @@ 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;
 
 /**
@@ -37,6 +38,7 @@ import org.alfresco.service.cmr.repository.NodeRef;
  * @author Roy Wetherall
  * @since 2.1
  */
+@AlfrescoPublicApi
 public interface ExtendedSecurityService
 {
 	/**

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
 {

rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/security/FilePlanPermissionService.java

@@ -27,6 +27,7 @@
 
 package org.alfresco.module.org_alfresco_module_rm.security;
 
+import org.alfresco.api.AlfrescoPublicApi;
 import org.alfresco.service.cmr.repository.NodeRef;
 
 /**
@@ -35,6 +36,7 @@ import org.alfresco.service.cmr.repository.NodeRef;
  * @author Roy Wetherall
  * @since 2.1
  */
+@AlfrescoPublicApi
 public interface FilePlanPermissionService
 {
     /**

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
 {
     /**

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
 {
     /**

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 */

rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/util/TransactionalResourceHelper.java

@@ -32,6 +32,8 @@ import java.util.Map;
 import java.util.Set;
 import java.util.TreeSet;
 
+import org.alfresco.api.AlfrescoPublicApi;
+
 /**
  * Delegate spring bean for TransactionResourceHelper
  *
@@ -39,6 +41,7 @@ import java.util.TreeSet;
  * @since 2.3
  * @see org.alfresco.repo.transaction.TransactionalResourceHelper
  */
+@AlfrescoPublicApi
 public class TransactionalResourceHelper
 {
     /**

rm-community/rm-community-repo/source/java/org/alfresco/module/org_alfresco_module_rm/version/RecordableVersionService.java

@@ -27,6 +27,7 @@
 
 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;
 
@@ -36,6 +37,7 @@ import org.alfresco.service.cmr.version.Version;
  * @author Roy Wetherall
  * @since 2.3
  */
+@AlfrescoPublicApi
 public interface RecordableVersionService
 {
     /**

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' */

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"),