Compare commits

..

28 Commits

Author SHA1 Message Date
27f2c2677c v3.x; upgrade to jakarta libs 2024-08-15 10:49:32 -04:00
783d93dfe2 Merge branch 'develop-acs62' into develop-acs7 2023-08-25 11:49:04 -04:00
14853ca9ca Merge branch 'develop-acs61' into develop-acs62 2023-08-25 11:48:55 -04:00
91f215ec1d Merge branch 'develop-acs60' into develop-acs61 2023-08-25 11:48:36 -04:00
c637298e3b Merge branch 'develop-acs52' into develop-acs60 2023-08-25 11:48:30 -04:00
224a40c1eb added multi-value property support 2023-08-25 11:48:05 -04:00
3718b3afb1 added Model API path 2023-06-16 10:16:17 -04:00
b06c7a5b6e Merge branch 'develop-acs62' into develop-acs7 2023-06-16 10:10:49 -04:00
6becd9fbcd moved search codegen to fix sizeInBytes type 2023-06-16 10:10:00 -04:00
573804252b Merge branch 'develop-acs61' into develop-acs62 2023-06-16 09:51:20 -04:00
151366e787 Merge branch 'develop-acs60' into develop-acs61 2023-06-16 09:49:53 -04:00
af23be4e64 modified path replacement for ACS v6.x+ 2023-06-16 09:47:40 -04:00
b420e53a58 Merge branch 'develop-acs52' into develop-acs60 2023-06-16 09:40:32 -04:00
4587c4d05a Merge branch 'develop-acs51' into develop-acs52 2023-06-16 09:39:43 -04:00
a11aced4e3 completed v5.1 support with swagger v3.x 2023-06-16 09:27:25 -04:00
27fb71e636 switch to swagger v3 2023-06-15 11:01:07 -04:00
457bdec3ec updated API to v7.3.0 2023-06-08 13:40:02 -04:00
afa78f27d5 Merge branch 'develop-acs62' into develop-acs7 2023-05-28 12:13:06 -04:00
11f1b54dc2 Merge branch 'develop-acs61' into develop-acs62 2023-05-28 12:12:53 -04:00
0f32bb67c0 Merge branch 'develop-acs60' into develop-acs61 2023-05-28 12:12:39 -04:00
4563273606 Merge branch 'develop-acs52' into develop-acs60 2023-05-28 12:12:24 -04:00
6ad9c87d13 Merge branch 'develop-acs51' into develop-acs52 2023-05-28 12:12:10 -04:00
abaf53d0d4 upgraded dependency versions
(cherry picked from commit 96d8d32f419ff3b337d6060c570b5ed5de9e22ec)
2023-05-28 12:11:22 -04:00
1ec8da218f upgraded regex plugin version
(cherry picked from commit a9c20f58e69d3e6c013be8088189b2f7932a68eb)
2023-05-28 12:11:13 -04:00
39bdc3ab0d Merge branch 'develop-acs62' into develop-acs7 2022-10-02 18:45:09 -04:00
89515eb147 Merge branch 'develop-acs61' into develop-acs62 2022-10-02 18:44:51 -04:00
e80401167a added ACS v7.0 changes 2022-10-02 18:40:35 -04:00
2d05f7a2a5 not ACS v6.2 changes; just version tag 2022-10-02 18:33:58 -04:00
8 changed files with 163 additions and 69 deletions

11
.gitignore vendored
View File

@@ -1,10 +1,6 @@
# Maven
pom.xml.versionsBackup
target
# Maven Invoker
build.log
invoker-reports
pom.xml.versionsBackup
# Eclipse
.project
@@ -13,8 +9,9 @@ invoker-reports
# Visual Studio Code
.factorypath
.vscode
# Swagger Codegen
src/gen
.swagger-codegen
.swagger-codegen-ignore
.swagger*

111
pom.xml
View File

@@ -5,10 +5,10 @@
<groupId>com.inteligr8.alfresco</groupId>
<artifactId>acs-public-rest-api</artifactId>
<version>2.0.1-acs61</version>
<version>3.0-SNAPSHOT-acs7</version>
<name>Alfresco Content Services ReST API for Java</name>
<description>A library for building ACS v6.1.x JAX-RS REST API clients</description>
<description>A library for building ACS v7.x JAX-RS REST API clients</description>
<url>https://bitbucket.org/inteligr8/acs-public-rest-api</url>
<licenses>
@@ -38,39 +38,54 @@
<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.source>11</maven.compiler.source>
<maven.compiler.target>11</maven.compiler.target>
<maven.compiler.debuglevel>lines,vars,source</maven.compiler.debuglevel>
<swagger.basePackage>com.inteligr8.alfresco.acs</swagger.basePackage>
<alfresco.platform.version>6.1.0</alfresco.platform.version>
<alfresco.platform.version>7.3.0</alfresco.platform.version>
<jersey.version>2.35</jersey.version>
<cxf.version>3.4.7</cxf.version>
<jersey.version>3.1.8</jersey.version>
<cxf.version>4.0.2</cxf.version>
<jackson.version>2.17.2</jackson.version>
</properties>
<dependencies>
<dependency>
<groupId>io.swagger</groupId>
<artifactId>swagger-jaxrs</artifactId>
<version>1.6.2</version>
<exclusions>
<exclusion>
<groupId>javax.ws.rs</groupId>
<artifactId>jsr311-api</artifactId>
</exclusion>
</exclusions>
<artifactId>swagger-annotations</artifactId>
<version>1.6.11</version>
</dependency>
<dependency>
<groupId>io.swagger.core.v3</groupId>
<artifactId>swagger-annotations</artifactId>
<version>2.2.11</version>
</dependency>
<dependency>
<groupId>jakarta.activation</groupId>
<artifactId>jakarta.activation-api</artifactId>
<version>2.1.3</version>
</dependency>
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-api</artifactId>
<version>2.0.7</version>
</dependency>
<dependency>
<groupId>jakarta.ws.rs</groupId>
<artifactId>jakarta.ws.rs-api</artifactId>
<version>2.1.6</version>
<version>3.1.0</version>
</dependency>
<dependency>
<groupId>jakarta.xml.bind</groupId>
<artifactId>jakarta.xml.bind-api</artifactId>
<version>4.0.1</version>
</dependency>
<dependency>
<groupId>com.fasterxml.jackson.module</groupId>
<artifactId>jackson-module-jaxb-annotations</artifactId>
<version>2.12.2</version>
<version>${jackson.version}</version>
</dependency>
<dependency>
<groupId>org.apache.cxf</groupId>
@@ -119,11 +134,14 @@
</executions>
</plugin>
<plugin>
<groupId>io.swagger</groupId>
<groupId>io.swagger.codegen.v3</groupId>
<artifactId>swagger-codegen-maven-plugin</artifactId>
<version>2.4.21</version>
<version>3.0.61</version>
<configuration>
<language>jaxrs-cxf-client</language>
<configOptions>
<jakarta>true</jakarta>
</configOptions>
<output>${basedir}</output>
<apiPackage>${swagger.basePackage}.api</apiPackage>
<modelPackage>${swagger.basePackage}.model</modelPackage>
@@ -134,6 +152,17 @@
<generateModelDocumentation>false</generateModelDocumentation>
</configuration>
<executions>
<!-- search before core, as ContentInfo is incorrect in search -->
<execution>
<id>swagger-search-codegen</id>
<phase>generate-sources</phase>
<goals>
<goal>generate</goal>
</goals>
<configuration>
<inputSpec>${project.build.directory}/dependency/definitions/alfresco-search.yaml</inputSpec>
</configuration>
</execution>
<execution>
<id>swagger-core-codegen</id>
<phase>generate-sources</phase>
@@ -145,13 +174,13 @@
</configuration>
</execution>
<execution>
<id>swagger-search-codegen</id>
<id>swagger-workflow-codegen</id>
<phase>generate-sources</phase>
<goals>
<goal>generate</goal>
</goals>
<configuration>
<inputSpec>${project.build.directory}/dependency/definitions/alfresco-search.yaml</inputSpec>
<inputSpec>${project.build.directory}/dependency/definitions/alfresco-workflow.yaml</inputSpec>
</configuration>
</execution>
<execution>
@@ -174,12 +203,22 @@
<inputSpec>${project.build.directory}/dependency/definitions/alfresco-discovery.yaml</inputSpec>
</configuration>
</execution>
<execution>
<id>swagger-model-codegen</id>
<phase>generate-sources</phase>
<goals>
<goal>generate</goal>
</goals>
<configuration>
<inputSpec>${project.build.directory}/dependency/definitions/alfresco-model.yaml</inputSpec>
</configuration>
</execution>
</executions>
</plugin>
<plugin>
<groupId>com.inteligr8</groupId>
<artifactId>regex-maven-plugin</artifactId>
<version>1.0.3</version>
<version>1.0.5</version>
<executions>
<execution>
<id>fix-baseUrl</id>
@@ -201,24 +240,32 @@
<replacement></replacement>
</regex>
<regex>
<pattern>(\*\*Core API\*\*[^@]*)@Path\("/"\)([^@]*)@Api\(value = "/"</pattern>
<replacement>$1@Path("/api/-default-/public/alfresco/versions/1")$2@Api(value = "/api/-default-/public/alfresco/versions/1"</replacement>
<pattern>public NodeEntry createNode\(@Multipart.*</pattern>
<previousPattern>/\*\*</previousPattern>
</regex>
<regex>
<pattern>(\*\*Search API\*\*[^@]*)@Path\("/"\)([^@]*)@Api\(value = "/"</pattern>
<replacement>$1@Path("/api/-default-/public/search/versions/1")$2@Api(value = "/api/-default-/public/search/versions/1"</replacement>
<pattern>(\*\*Core API\*\*[^@]*)@Path\("/"\)</pattern>
<replacement>$1@Path("/api/-default-/public/alfresco/versions/1")</replacement>
</regex>
<regex>
<pattern>(\*\*Model API\*\*[^@]*)@Path\("/"\)([^@]*)@Api\(value = "/"</pattern>
<replacement>$1@Path("/api/-default-/public/alfresco/versions/1")$2@Api(value = "/api/-default-/public/alfresco/versions/1"</replacement>
<pattern>(\*\*Workflow API\*\*[^@]*)@Path\("/"\)</pattern>
<replacement>$1@Path("/api/-default-/public/workflow/versions/1")</replacement>
</regex>
<regex>
<pattern>(\*\*Authentication API\*\*[^@]*)@Path\("/"\)([^@]*)@Api\(value = "/"</pattern>
<replacement>$1@Path("/api/-default-/public/authentication/versions/1")$2@Api(value = "/api/-default-/public/authentication/versions/1"</replacement>
<pattern>(\*\*Authentication API\*\*[^@]*)@Path\("/"\)</pattern>
<replacement>$1@Path("/api/-default-/public/authentication/versions/1")</replacement>
</regex>
<regex>
<pattern>(\*\*Discovery API\*\*[^@]*)@Path\("/"\)([^@]*)@Api\(value = "/"</pattern>
<replacement>$1@Path("/api")$2@Api(value = "/api"</replacement>
<pattern>(\*\*Discovery API\*\*[^@]*)@Path\("/"\)</pattern>
<replacement>$1@Path("/api")</replacement>
</regex>
<regex>
<pattern>(\*\*Search API\*\*[^@]*)@Path\("/"\)</pattern>
<replacement>$1@Path("/api/-default-/public/search/versions/1")</replacement>
</regex>
<regex>
<pattern>(\*\*Model API\*\*[^@]*)@Path\("/"\)</pattern>
<replacement>$1@Path("/api/-default-/public/alfresco/versions/1")</replacement>
</regex>
</regexes>
</configuration>

View File

@@ -16,9 +16,11 @@ package com.inteligr8.alfresco.acs;
import com.inteligr8.alfresco.acs.api.ActionsApi;
import com.inteligr8.alfresco.acs.api.ActivitiesApi;
import com.inteligr8.alfresco.acs.api.AspectsApi;
import com.inteligr8.alfresco.acs.api.AuditApi;
import com.inteligr8.alfresco.acs.api.AuthenticationApi;
import com.inteligr8.alfresco.acs.api.CommentsApi;
import com.inteligr8.alfresco.acs.api.DeploymentsApi;
import com.inteligr8.alfresco.acs.api.DiscoveryApi;
import com.inteligr8.alfresco.acs.api.DownloadsApi;
import com.inteligr8.alfresco.acs.api.FavoritesApi;
@@ -28,6 +30,8 @@ import com.inteligr8.alfresco.acs.api.NodesApi;
import com.inteligr8.alfresco.acs.api.PeopleApi;
import com.inteligr8.alfresco.acs.api.PreferencesApi;
import com.inteligr8.alfresco.acs.api.ProbesApi;
import com.inteligr8.alfresco.acs.api.ProcessDefinitionsApi;
import com.inteligr8.alfresco.acs.api.ProcessesApi;
import com.inteligr8.alfresco.acs.api.QueriesApi;
import com.inteligr8.alfresco.acs.api.RatingsApi;
import com.inteligr8.alfresco.acs.api.RenditionsApi;
@@ -35,7 +39,9 @@ import com.inteligr8.alfresco.acs.api.SearchApi;
import com.inteligr8.alfresco.acs.api.SharedLinksApi;
import com.inteligr8.alfresco.acs.api.SitesApi;
import com.inteligr8.alfresco.acs.api.TagsApi;
import com.inteligr8.alfresco.acs.api.TasksApi;
import com.inteligr8.alfresco.acs.api.TrashcanApi;
import com.inteligr8.alfresco.acs.api.TypesApi;
import com.inteligr8.alfresco.acs.api.V0Api;
import com.inteligr8.alfresco.acs.api.VersionsApi;
@@ -56,6 +62,10 @@ public interface AcsPublicRestApi {
default ActivitiesApi getActivitiesApi() {
return this.getApi(ActivitiesApi.class);
}
default AspectsApi getAspectsApi() {
return this.getApi(AspectsApi.class);
}
default AuditApi getAuditApi() {
return this.getApi(AuditApi.class);
@@ -68,6 +78,10 @@ public interface AcsPublicRestApi {
default CommentsApi getCommentsApi() {
return this.getApi(CommentsApi.class);
}
default DeploymentsApi getDeploymentsApi() {
return this.getApi(DeploymentsApi.class);
}
default DiscoveryApi getDiscoveryApi() {
return this.getApi(DiscoveryApi.class);
@@ -96,10 +110,18 @@ public interface AcsPublicRestApi {
default PeopleApi getPeopleApi() {
return this.getApi(PeopleApi.class);
}
default PreferencesApi getPreferencesApi() {
return this.getApi(PreferencesApi.class);
}
default PreferencesApi getPreferencesApi() {
return this.getApi(PreferencesApi.class);
}
default ProcessDefinitionsApi getProcessDefinitionApi() {
return this.getApi(ProcessDefinitionsApi.class);
}
default ProcessesApi getProcessesApi() {
return this.getApi(ProcessesApi.class);
}
default ProbesApi getProbesApi() {
return this.getApi(ProbesApi.class);
@@ -132,11 +154,19 @@ public interface AcsPublicRestApi {
default TagsApi getTagsApi() {
return this.getApi(TagsApi.class);
}
default TasksApi getTasksApi() {
return this.getApi(TasksApi.class);
}
default TrashcanApi getTrashcanApi() {
return this.getApi(TrashcanApi.class);
}
default TypesApi getTypesApi() {
return this.getApi(TypesApi.class);
}
default VersionsApi getVersionsApi() {
return this.getApi(VersionsApi.class);
}

View File

@@ -14,12 +14,12 @@
*/
package com.inteligr8.alfresco.acs.api;
import javax.ws.rs.Consumes;
import javax.ws.rs.POST;
import javax.ws.rs.Path;
import javax.ws.rs.PathParam;
import javax.ws.rs.Produces;
import javax.ws.rs.core.MediaType;
import jakarta.ws.rs.Consumes;
import jakarta.ws.rs.POST;
import jakarta.ws.rs.Path;
import jakarta.ws.rs.PathParam;
import jakarta.ws.rs.Produces;
import jakarta.ws.rs.core.MediaType;
import com.inteligr8.alfresco.acs.model.Error;
import com.inteligr8.alfresco.acs.model.NodeBodyCreateMultipartCxf;

View File

@@ -14,12 +14,12 @@
*/
package com.inteligr8.alfresco.acs.api;
import javax.ws.rs.Consumes;
import javax.ws.rs.POST;
import javax.ws.rs.Path;
import javax.ws.rs.PathParam;
import javax.ws.rs.Produces;
import javax.ws.rs.core.MediaType;
import jakarta.ws.rs.Consumes;
import jakarta.ws.rs.POST;
import jakarta.ws.rs.Path;
import jakarta.ws.rs.PathParam;
import jakarta.ws.rs.Produces;
import jakarta.ws.rs.core.MediaType;
import com.inteligr8.alfresco.acs.model.Error;
import com.inteligr8.alfresco.acs.model.NodeBodyCreateMultipartJersey;

View File

@@ -16,11 +16,11 @@ package com.inteligr8.alfresco.acs.api;
import java.util.List;
import javax.ws.rs.GET;
import javax.ws.rs.Path;
import javax.ws.rs.PathParam;
import javax.ws.rs.Produces;
import javax.ws.rs.QueryParam;
import jakarta.ws.rs.GET;
import jakarta.ws.rs.Path;
import jakarta.ws.rs.PathParam;
import jakarta.ws.rs.Produces;
import jakarta.ws.rs.QueryParam;
import com.inteligr8.alfresco.acs.model.v0.AssociationInfo;
import com.inteligr8.alfresco.acs.model.v0.ClassInfo;

View File

@@ -17,12 +17,13 @@ package com.inteligr8.alfresco.acs.model;
import java.io.ByteArrayInputStream;
import java.io.IOException;
import java.io.InputStream;
import java.util.Collection;
import java.util.LinkedList;
import java.util.List;
import java.util.Map;
import java.util.Map.Entry;
import javax.ws.rs.core.MediaType;
import jakarta.ws.rs.core.MediaType;
import org.apache.cxf.jaxrs.ext.multipart.Attachment;
import org.apache.cxf.jaxrs.ext.multipart.ContentDisposition;
@@ -90,9 +91,18 @@ public class NodeBodyCreateMultipartCxf extends MultipartBody {
if (nodeBody.getAspectNames() != null && !nodeBody.getAspectNames().isEmpty())
logger.warn("The ACS Public REST API does not support the explicit inclusion of aspects while creating content");
if (nodeBody.getProperties() != null) {
Map<String, ?> props = (Map<String, ?>)nodeBody.getProperties();
@SuppressWarnings("unchecked")
Map<String, ?> props = (Map<String, ?>)nodeBody.getProperties();
for (Entry<String, ?> prop : props.entrySet()) {
if (prop.getValue() != null) {
if (prop.getValue() instanceof Collection<?>) {
for (Object value : (Collection<?>)prop.getValue())
if (value != null)
atts.add(toAttachment(prop.getKey(), value.toString()));
} else if (prop.getValue() instanceof Object[]) {
for (Object value : (Object[])prop.getValue())
if (value != null)
atts.add(toAttachment(prop.getKey(), value.toString()));
} else if (prop.getValue() != null) {
// FIXME convert dates as ACS would expect them to be formatted
atts.add(toAttachment(prop.getKey(), prop.getValue().toString()));
}

View File

@@ -17,12 +17,13 @@ package com.inteligr8.alfresco.acs.model;
import java.io.IOException;
import java.io.InputStream;
import java.text.ParseException;
import java.util.Collection;
import java.util.LinkedList;
import java.util.List;
import java.util.Map;
import java.util.Map.Entry;
import javax.ws.rs.core.MediaType;
import jakarta.ws.rs.core.MediaType;
import org.glassfish.jersey.media.multipart.BodyPart;
import org.glassfish.jersey.media.multipart.FormDataBodyPart;
@@ -86,12 +87,21 @@ public class NodeBodyCreateMultipartJersey extends FormDataMultiPart {
if (nodeBody.getAspectNames() != null && !nodeBody.getAspectNames().isEmpty())
logger.warn("The ACS Public REST API does not support the explicit inclusion of aspects while creating content");
if (nodeBody.getProperties() != null) {
Map<String, ?> props = (Map<String, ?>)nodeBody.getProperties();
@SuppressWarnings("unchecked")
Map<String, ?> props = (Map<String, ?>)nodeBody.getProperties();
for (Entry<String, ?> prop : props.entrySet()) {
if (prop.getValue() != null) {
// FIXME convert dates as ACS would expect them to be formatted
fields.add(new FormDataBodyPart(prop.getKey(), prop.getValue().toString()));
}
if (prop.getValue() instanceof Collection<?>) {
for (Object value : (Collection<?>)prop.getValue())
if (value != null)
fields.add(new FormDataBodyPart(prop.getKey(), value.toString()));
} else if (prop.getValue() instanceof Object[]) {
for (Object value : (Object[])prop.getValue())
if (value != null)
fields.add(new FormDataBodyPart(prop.getKey(), value.toString()));
} else if (prop.getValue() != null) {
// FIXME convert dates as ACS would expect them to be formatted
fields.add(new FormDataBodyPart(prop.getKey(), prop.getValue().toString()));
}
}
}