Skip to content

Commit

Permalink
Merge pull request #22 from dgradecak/dev
Browse files Browse the repository at this point in the history
Dev
  • Loading branch information
dgradecak authored Sep 25, 2022
2 parents e2e5e7a + 637b21a commit 919d2a6
Show file tree
Hide file tree
Showing 57 changed files with 641 additions and 2,065 deletions.
65 changes: 28 additions & 37 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,30 @@
The missing glue between Alfresco and Spring MVC
===
Works on Enterprise as well as on Community and it ruses a widely accepted REST framework
Personally I do not like webscripts because of the boilerplate code that comes with them (XML, FTL, Java/Javascript). Also I am not a big fan of javascript on the server side esither, as in a medium sized application this becomes unmaintainable. That is why I wrote Alfresco @MVC.

Alfresco @MVC consists of several libraries for REST, AOP
- Alfresco MVC REST enables the usage of the full Spring MVC stack within the context of a webscript, benefiting of Alfresco standard authentication and security
- Alfresco MVC AOP enables simple handling of Alfresco transactions and Alfresco runAs mechanism with simple annotations

[Distributed on Maven Central](https://search.maven.org/search?q=g:com.gradecak.alfresco-mvc)

```
<dependency>
<groupId>com.gradecak.alfresco-mvc</groupId>
<artifactId>alfresco-mvc-rest</artifactId>
<version>xxx</version>
</dependency>
<dependency>
<groupId>com.gradecak.alfresco-mvc</groupId>
<artifactId>alfresco-mvc-aop</artifactId>
<version>xxx</version>
</dependency>
```

Works on Enterprise as well as on Community and it reuses a widely accepted REST framework.
For the correct version supported on your Alfresco version [please check the wiki](https://github.com/dgradecak/alfresco-mvc/wiki) or
[the release page](https://github.com/dgradecak/alfresco-mvc/releases).

[The docs are on the wiki page](https://github.com/dgradecak/alfresco-mvc/wiki)

Expand All @@ -12,42 +36,9 @@ You should use it when

You would benefit of
-
- Faster development
- Java developers know how to use Spring MVC


Supported Alfresco versions
----
v7.5.0-RELEASE
-
- Possibility to disable parent context servlet behavior @AlfrescoDispatcherWebscript(... servletConfigOptions = {ServletConfigOptions.DISABLED_PARENT_HANDLER_MAPPINGS, ...})
- DispatcherWebscript servlet context can inherit all parent context properties (alfresco global included), or by annotation @AlfrescoDispatcherWebscript(inheritGlobalProperties = true, ...)
- Tested on Alfresco Community 6.2.0-GA
- Tested on Alfresco Enterprise 6.2
- Faster and cleaner development
- Java developers know how to use Spring MVC while new comers tend to avoid webscripts

v7
-
- the querytemplate module has been deprecated and will be removed in the next major release (Alfresco 5.2+ include a REST API and we recommend using classes from the package org.alfresco.rest.api)
- @AlfrescoRestResponse can be used to annotate a controller or a controller method in order to use Alfresco Rest API response processing
- clearer isolation of Spring MVC Web and specific Jackson processors have been removed by default, since spring has been updated to 5.1.x in Alfresco ACS and Alfresco introduced org.alfresco.rest.framework.jacksonextensions.RestJsonModule which we are reusing now.
Therefore if you want to continue using any of the serializers/deserializers or converters/formatters you need to manually include them in your WebMvcConfigurer implementation
- use @EnableWebAlfrescoMvc which enables @EnableWebMvc and reuses com.gradecak.alfresco.mvc.rest.config.DefaultAlfrescoMvcServletContextConfig otherwise just use @EnableWebMvc and customize your servlet context as needed
- ResponseMapBuilder has been deprecated use a Map instead
- Tested on Alfresco Community 6.0.7-GA, 6.1.x, 6.2.0-GA
- Tested on Alfresco Enterprise 6.0.1, 6.1, 6.2

v6
-
- Tested on Alfresco Community 6.0.7-GA, 6.1.x, 6.2.0-A2
- Tested on Alfresco Enterprise 6.0.1, 6.1, 6.2
- there is an known issue with AGS/RM that can be easily avoided by not using the default servlet context configuration

v5
-
- Tested on Alfresco Community 3.4.d, 4.0.x, 4.2.x, 5.0.a, 5.0.d, 5.1.e, 5.2.f, 5.2.g (might work with older version, if not please check previous releases/snapshots)
- Tested on Alfresco Enterprise 3.4.5, 4.1.5, 4.2.1, 5.1.x, 5.2.x (might work with older version, if not please check previous releases/snapshots)
For supported Alfresco versions check the [release notes](https://github.com/dgradecak/alfresco-mvc/releases)

v4
-
- Tested on Alfresco Community 3.4.d, 4.0.x, 4.2.x, 5.0.a, 5.0.d, 5.1.e, 5.2.f, 5.2.g (might work with older version, if not please check previous releases/snapshots)
- Tested on Alfresco Enterprise 3.4.5, 4.1.5, 4.2.1, 5.1.x, 5.2.x (might work with older version, if not please check previous releases/snapshots)
2 changes: 1 addition & 1 deletion alfresco-mvc-aop/pom.xml
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@

<parent>
<groupId>com.gradecak.alfresco-mvc</groupId>
<version>7.5.1-RELEASE</version>
<version>8.0.0</version>
<artifactId>alfresco-mvc-bom</artifactId>
<relativePath>../</relativePath>
</parent>
Expand Down
70 changes: 0 additions & 70 deletions alfresco-mvc-querytemplate/pom.xml

This file was deleted.

This file was deleted.

Loading

0 comments on commit 919d2a6

Please sign in to comment.