v2.0.3-aps1 POM

pom.xml

@@ -2,21 +2,46 @@
 		xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 		xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
 	<modelVersion>4.0.0</modelVersion>
+
 	<groupId>com.inteligr8.alfresco</groupId>
 	<artifactId>aps-public-rest-api</artifactId>
-	<version>2.0.0</version>
+	<version>2.0.3-aps1</version>
+
 	<name>Alfresco Process Services ReST API for Java</name>
+	<description>An APS API library for APS v1.x REST API clients</description>
+	<url>https://bitbucket.org/inteligr8/aps-public-rest-api</url>
+
+	<licenses>
+		<license>
+			<name>GNU GENERAL PUBLIC LICENSE, Version 3, 29 June 2007</name>
+			<url>https://www.gnu.org/licenses/lgpl-3.0.txt</url>
+		</license>
+	</licenses>
+
+	<scm>
+		<connection>scm:git:https://bitbucket.org/inteligr8/aps-public-rest-api.git</connection>
+		<developerConnection>scm:git:git@bitbucket.org:inteligr8/aps-public-rest-api.git</developerConnection>
+		<url>https://bitbucket.org/inteligr8/aps-public-rest-api</url>
+	</scm>
+	<organization>
+		<name>Inteligr8</name>
+		<url>https://www.inteligr8.com</url>
+	</organization>
+	<developers>
+		<developer>
+			<id>brian.long</id>
+			<name>Brian Long</name>
+			<email>brian@inteligr8.com</email>
+			<url>https://twitter.com/brianmlong</url>
+		</developer>
+	</developers>
 
 	<properties>
 		<project.build.sourceEncoding>utf-8</project.build.sourceEncoding>
 		<maven.compiler.source>8</maven.compiler.source>
 		<maven.compiler.target>8</maven.compiler.target>
 		<maven.compiler.debuglevel>lines,vars,source</maven.compiler.debuglevel>
-
-		<!-- If you want to build for your specific version, point to your own 
-			installation -->
-		<aps.app.tag>aps1</aps.app.tag>
-
+		
 		<jersey.version>2.35</jersey.version>
 		<cxf.version>3.4.7</cxf.version>
 	</properties>
@@ -45,31 +70,6 @@
 			<optional>true</optional>
 		</dependency>
 	</dependencies>
-	
-	<build>
-		<plugins>
-			<plugin>
-				<artifactId>maven-jar-plugin</artifactId>
-				<configuration>
-					<classifier>${aps.app.tag}</classifier>
-				</configuration>
-			</plugin>
-			<plugin>
-				<artifactId>maven-javadoc-plugin</artifactId>
-				<version>3.3.2</version>
-				<executions>
-					<execution>
-						<id>javadoc</id>
-						<phase>package</phase>
-						<goals><goal>jar</goal></goals>
-						<configuration>
-							<show>public</show>
-						</configuration>
-					</execution>
-				</executions>
-			</plugin>
-		</plugins>
-	</build>
 
 	<profiles>
 		<!-- Implement when descriptor is available -->
@@ -201,32 +201,74 @@
 				</plugins>
 			</build>
 		</profile>
+		<profile>
+			<id>ossrh-release</id>
+			<properties>
+				<maven.deploy.skip>true</maven.deploy.skip>
+			</properties>
+			<build>
+				<plugins>
+					<plugin>
+						<artifactId>maven-source-plugin</artifactId>
+						<executions>
+							<execution>
+								<id>source</id>
+								<phase>package</phase>
+								<goals><goal>jar-no-fork</goal></goals>
+							</execution>
+						</executions>
+					</plugin>
+					<plugin>
+						<artifactId>maven-javadoc-plugin</artifactId>
+						<version>3.3.2</version>
+						<executions>
+							<execution>
+								<id>javadoc</id>
+								<phase>package</phase>
+								<goals><goal>jar</goal></goals>
+								<configuration>
+									<show>public</show>
+									<additionalJOption>-Xdoclint:none</additionalJOption>
+								</configuration>
+							</execution>
+						</executions>
+					</plugin>
+					<plugin>
+						<artifactId>maven-gpg-plugin</artifactId>
+						<executions>
+							<execution>
+								<id>sign</id>
+								<phase>verify</phase>
+								<goals><goal>sign</goal></goals>
+							</execution>
+						</executions>
+					</plugin>
+					<plugin>
+						<groupId>org.sonatype.plugins</groupId>
+						<artifactId>nexus-staging-maven-plugin</artifactId>
+						<version>1.6.13</version>
+						<configuration>
+							<serverId>ossrh</serverId>
+							<nexusUrl>https://s01.oss.sonatype.org/</nexusUrl>
+							<autoReleaseAfterClose>true</autoReleaseAfterClose>
+						</configuration>
+						<executions>
+							<execution>
+								<id>ossrh-deploy</id>
+								<phase>deploy</phase>
+								<goals><goal>deploy</goal></goals>
+							</execution>
+						</executions>
+					</plugin>
+				</plugins>
+			</build>
+		</profile>
 	</profiles>
 	
-	<repositories>
-		<repository>
-			<id>inteligr8-releases</id>
-			<url>https://repos.inteligr8.com/nexus/repository/inteligr8-public</url>
-			<releases><enabled>true</enabled></releases>
-			<snapshots><enabled>false</enabled></snapshots>
-		</repository>
-	</repositories>
-	
 	<pluginRepositories>
 		<pluginRepository>
 			<id>mulesoft-releases</id>
 			<url>https://repository.mulesoft.org/releases</url>
 		</pluginRepository>
-		<pluginRepository>
-			<id>inteligr8-public</id>
-			<url>https://repos.inteligr8.com/nexus/repository/inteligr8-public</url>
-		</pluginRepository>
 	</pluginRepositories>
-	
-	<distributionManagement>
-		<repository>
-			<id>inteligr8-releases</id>
-			<url>https://repos.inteligr8.com/nexus/repository/inteligr8-public</url>
-		</repository>
-	</distributionManagement>
 </project>

src/main/java/com/inteligr8/alfresco/activiti/ApsPublicRestApi.java

@@ -1,3 +1,17 @@
+/*
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or (at your
+ * option) any later version.
+ * 
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
+ * more details.
+ * 
+ * You should have received a copy of the GNU General Public License along
+ * with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
 package com.inteligr8.alfresco.activiti;
 
 import com.inteligr8.alfresco.activiti.api.AdminApi;
@@ -6,6 +20,7 @@ import com.inteligr8.alfresco.activiti.api.AppVersionApi;
 import com.inteligr8.alfresco.activiti.api.ModelsApi;
 import com.inteligr8.alfresco.activiti.api.ProcessInstancesApi;
 import com.inteligr8.alfresco.activiti.api.ProfileApi;
+import com.inteligr8.alfresco.activiti.api.ShareApi;
 import com.inteligr8.alfresco.activiti.api.TasksApi;
 
 /**
@@ -16,18 +31,42 @@ import com.inteligr8.alfresco.activiti.api.TasksApi;
  */
 public interface ApsPublicRestApi {
 	
-	AdminApi getAdminApi();
+	<T> T getApi(Class<T> apiClass);
 	
-	AppDefinitionsApi getAppDefinitionsApi();
+	default AdminApi getAdminApi() {
+		return this.getApi(AdminApi.class);
+	}
 	
-	AppVersionApi getAppVersionApi();
+	default AppDefinitionsApi getAppDefinitionsApi() {
+		return this.getApi(AppDefinitionsApi.class);
+	}
 	
-	ModelsApi getModelsApi();
+	default AppVersionApi getAppVersionApi() {
+		return this.getApi(AppVersionApi.class);
+	}
 	
-	ProcessInstancesApi getProcessInstancesApi();
+	default ModelsApi getModelsApi() {
+		return this.getApi(ModelsApi.class);
+	}
 	
-	ProfileApi getProfileApi();
+	default ProcessInstancesApi getProcessInstancesApi() {
+		return this.getApi(ProcessInstancesApi.class);
+	}
 	
-	TasksApi getTasksApi();
+	default ProfileApi getProfileApi() {
+		return this.getApi(ProfileApi.class);
+	}
+	
+	default TasksApi getTasksApi() {
+		return this.getApi(TasksApi.class);
+	}
+	
+	
+	/**
+	 * The following are not part of the official open source or enterprise APIs
+	 */
+	default ShareApi getShareApi() {
+		return this.getApi(ShareApi.class);
+	}
 
 }

src/main/java/com/inteligr8/alfresco/activiti/ApsPublicRestCxfApi.java

@@ -11,6 +11,8 @@ import com.inteligr8.alfresco.activiti.api.AppDefinitionsCxfApi;
  */
 public interface ApsPublicRestCxfApi extends ApsPublicRestApi {
 	
-	AppDefinitionsCxfApi getAppDefinitionsCxfApi();
+	default AppDefinitionsCxfApi getAppDefinitionsCxfApi() {
+		return this.getApi(AppDefinitionsCxfApi.class);
+	}
 
 }

src/main/java/com/inteligr8/alfresco/activiti/ApsPublicRestJerseyApi.java

@@ -11,6 +11,8 @@ import com.inteligr8.alfresco.activiti.api.AppDefinitionsJerseyApi;
  */
 public interface ApsPublicRestJerseyApi extends ApsPublicRestApi {
 	
-	AppDefinitionsJerseyApi getAppDefinitionsJerseyApi();
+	default AppDefinitionsJerseyApi getAppDefinitionsJerseyApi() {
+		return this.getApi(AppDefinitionsJerseyApi.class);
+	}
 
 }

src/main/java/com/inteligr8/alfresco/activiti/api/AdminApi.java

@@ -1,4 +1,17 @@
-
+/*
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or (at your
+ * option) any later version.
+ * 
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
+ * more details.
+ * 
+ * You should have received a copy of the GNU General Public License along
+ * with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
 package com.inteligr8.alfresco.activiti.api;
 
 import java.util.List;

src/main/java/com/inteligr8/alfresco/activiti/api/AppDefinitionsApi.java

@@ -1,4 +1,17 @@
-
+/*
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or (at your
+ * option) any later version.
+ * 
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
+ * more details.
+ * 
+ * You should have received a copy of the GNU General Public License along
+ * with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
 package com.inteligr8.alfresco.activiti.api;
 
 import java.io.File;

src/main/java/com/inteligr8/alfresco/activiti/api/AppVersionApi.java

@@ -1,4 +1,17 @@
-
+/*
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or (at your
+ * option) any later version.
+ * 
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
+ * more details.
+ * 
+ * You should have received a copy of the GNU General Public License along
+ * with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
 package com.inteligr8.alfresco.activiti.api;
 
 import javax.ws.rs.GET;

src/main/java/com/inteligr8/alfresco/activiti/api/GroupsApi.java

@@ -1,4 +1,17 @@
-
+/*
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or (at your
+ * option) any later version.
+ * 
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
+ * more details.
+ * 
+ * You should have received a copy of the GNU General Public License along
+ * with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
 package com.inteligr8.alfresco.activiti.api;
 
 import javax.ws.rs.GET;

src/main/java/com/inteligr8/alfresco/activiti/api/ModelsApi.java

@@ -1,4 +1,17 @@
-
+/*
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or (at your
+ * option) any later version.
+ * 
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
+ * more details.
+ * 
+ * You should have received a copy of the GNU General Public License along
+ * with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
 package com.inteligr8.alfresco.activiti.api;
 
 import javax.ws.rs.GET;

src/main/java/com/inteligr8/alfresco/activiti/api/ProcessInstancesApi.java

@@ -1,4 +1,17 @@
-
+/*
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or (at your
+ * option) any later version.
+ * 
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
+ * more details.
+ * 
+ * You should have received a copy of the GNU General Public License along
+ * with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
 package com.inteligr8.alfresco.activiti.api;
 
 import java.util.List;

src/main/java/com/inteligr8/alfresco/activiti/api/ProfileApi.java

@@ -1,4 +1,17 @@
-
+/*
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or (at your
+ * option) any later version.
+ * 
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
+ * more details.
+ * 
+ * You should have received a copy of the GNU General Public License along
+ * with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
 package com.inteligr8.alfresco.activiti.api;
 
 import javax.ws.rs.GET;

src/main/java/com/inteligr8/alfresco/activiti/api/ShareApi.java

@@ -0,0 +1,50 @@
+/*
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or (at your
+ * option) any later version.
+ * 
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
+ * more details.
+ * 
+ * You should have received a copy of the GNU General Public License along
+ * with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+package com.inteligr8.alfresco.activiti.api;
+
+import javax.ws.rs.Consumes;
+import javax.ws.rs.GET;
+import javax.ws.rs.PUT;
+import javax.ws.rs.Path;
+import javax.ws.rs.PathParam;
+import javax.ws.rs.Produces;
+import javax.ws.rs.core.MediaType;
+
+import com.inteligr8.alfresco.activiti.model.ResultList;
+import com.inteligr8.alfresco.activiti.model.ShareInfoRequest;
+import com.inteligr8.alfresco.activiti.model.SharePermission;
+
+/**
+ * This is an undocumented API.
+ * 
+ * @author brian@inteligr8.com
+ */
+@Path("/app/rest/models")
+public interface ShareApi {
+
+    @GET
+    @Path("/{modelId}/share-info")
+    @Produces({ MediaType.APPLICATION_JSON })
+    public ResultList<SharePermission> getShareInfo(
+    		@PathParam("modelId") String modelId);
+
+    @PUT
+    @Path("/{modelId}/share-info")
+    @Consumes({ MediaType.APPLICATION_JSON })
+    public void setShareInfo(
+    		@PathParam("modelId") String modelId,
+    		ShareInfoRequest request);
+
+}

src/main/java/com/inteligr8/alfresco/activiti/api/TasksApi.java

@@ -1,4 +1,17 @@
-
+/*
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or (at your
+ * option) any later version.
+ * 
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
+ * more details.
+ * 
+ * You should have received a copy of the GNU General Public License along
+ * with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
 package com.inteligr8.alfresco.activiti.api;
 
 import java.util.List;

src/main/java/com/inteligr8/alfresco/activiti/model/Permission.java

@@ -0,0 +1,33 @@
+package com.inteligr8.alfresco.activiti.model;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import com.fasterxml.jackson.annotation.JsonInclude;
+import com.fasterxml.jackson.annotation.JsonProperty;
+
+@JsonIgnoreProperties(ignoreUnknown = true)
+@JsonInclude(JsonInclude.Include.NON_NULL)
+public class Permission extends PermissionLight {
+	
+	@JsonProperty
+	private UserLight person;
+	@JsonProperty
+	private GroupLight group;
+
+	public UserLight getPerson() {
+		return person;
+	}
+
+	public void setPerson(UserLight person) {
+		this.person = person;
+	}
+
+	public GroupLight getGroup() {
+		return group;
+	}
+
+	public void setGroup(GroupLight group) {
+		this.group = group;
+	}
+	
+
+}

src/main/java/com/inteligr8/alfresco/activiti/model/PermissionLevel.java

@@ -0,0 +1,13 @@
+package com.inteligr8.alfresco.activiti.model;
+
+import com.fasterxml.jackson.annotation.JsonProperty;
+
+public enum PermissionLevel {
+	
+	@JsonProperty("write")
+	Write,
+
+	@JsonProperty("read")
+	Read
+
+}

src/main/java/com/inteligr8/alfresco/activiti/model/PermissionLight.java

@@ -0,0 +1,73 @@
+package com.inteligr8.alfresco.activiti.model;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import com.fasterxml.jackson.annotation.JsonInclude;
+import com.fasterxml.jackson.annotation.JsonProperty;
+
+@JsonIgnoreProperties(ignoreUnknown = true)
+@JsonInclude(JsonInclude.Include.NON_NULL)
+public class PermissionLight {
+	
+	@JsonProperty
+	private String id;
+	@JsonProperty
+	private PermissionLevel permission;
+	@JsonProperty
+	private Long personId;
+	@JsonProperty
+	private Long groupId;
+
+	public String getId() {
+		return id;
+	}
+	
+	public void setId(String id) {
+		this.id = id;
+	}
+	
+	public PermissionLight withId(String id) {
+		this.setId(id);
+		return this;
+	}
+	
+	public PermissionLevel getPermission() {
+		return permission;
+	}
+	
+	public void setPermission(PermissionLevel permission) {
+		this.permission = permission;
+	}
+	
+	public PermissionLight withPermission(PermissionLevel permission) {
+		this.setPermission(permission);
+		return this;
+	}
+
+	public Long getPersonId() {
+		return personId;
+	}
+
+	public void setPersonId(Long personId) {
+		this.personId = personId;
+	}
+	
+	public PermissionLight withPersonId(Long personId) {
+		this.setPersonId(personId);
+		return this;
+	}
+
+	public Long getGroupId() {
+		return groupId;
+	}
+
+	public void setGroupId(Long groupId) {
+		this.groupId = groupId;
+	}
+	
+	public PermissionLight withGroupId(Long groupId) {
+		this.setGroupId(groupId);
+		return this;
+	}
+	
+
+}

src/main/java/com/inteligr8/alfresco/activiti/model/ShareInfoRequest.java

@@ -0,0 +1,47 @@
+package com.inteligr8.alfresco.activiti.model;
+
+import java.util.LinkedList;
+import java.util.List;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import com.fasterxml.jackson.annotation.JsonInclude;
+import com.fasterxml.jackson.annotation.JsonProperty;
+
+@JsonIgnoreProperties(ignoreUnknown = true)
+@JsonInclude(JsonInclude.Include.NON_NULL)
+public class ShareInfoRequest {
+	
+	@JsonProperty
+	private List<PermissionLight> added = new LinkedList<>();
+	@JsonProperty
+	private List<PermissionLight> removed = new LinkedList<>();
+	@JsonProperty
+	private List<PermissionLight> updated = new LinkedList<>();
+	
+	
+	
+	public List<PermissionLight> getAdded() {
+		return added;
+	}
+	
+	public void setAdded(List<PermissionLight> added) {
+		this.added = added;
+	}
+	
+	public List<PermissionLight> getRemoved() {
+		return removed;
+	}
+	
+	public void setRemoved(List<PermissionLight> removed) {
+		this.removed = removed;
+	}
+	
+	public List<PermissionLight> getUpdated() {
+		return updated;
+	}
+	
+	public void setUpdated(List<PermissionLight> updated) {
+		this.updated = updated;
+	}
+
+}

src/main/java/com/inteligr8/alfresco/activiti/model/SharePermission.java

@@ -0,0 +1,34 @@
+package com.inteligr8.alfresco.activiti.model;
+
+import java.time.OffsetDateTime;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import com.fasterxml.jackson.annotation.JsonInclude;
+import com.fasterxml.jackson.annotation.JsonProperty;
+
+@JsonIgnoreProperties(ignoreUnknown = true)
+@JsonInclude(JsonInclude.Include.NON_NULL)
+public class SharePermission extends Permission {
+	
+	@JsonProperty
+	private OffsetDateTime shareDate;
+	@JsonProperty
+	private Long sharedBy;
+	
+	public OffsetDateTime getShareDate() {
+		return shareDate;
+	}
+	
+	public void setShareDate(OffsetDateTime shareDate) {
+		this.shareDate = shareDate;
+	}
+	
+	public Long getSharedBy() {
+		return sharedBy;
+	}
+	
+	public void setSharedBy(Long sharedBy) {
+		this.sharedBy = sharedBy;
+	}
+
+}