Skip to content

Latest commit

 

History

History
144 lines (107 loc) · 4.89 KB

README.md

File metadata and controls

144 lines (107 loc) · 4.89 KB
Raw

The Angus Activation is a compatible implementation of the Jakarta Activation Specification 2.1+ which lets you take advantage of standard services to: determine the type of an arbitrary piece of data; encapsulate access to it; discover the operations available on it; and instantiate the appropriate bean to perform the operation(s).

This project is part of Eclipse Angus project.

Table of Contents

Latest News

TBD - Angus Activation 2.0.0 Final Release

Changes module name from com.sun.activation.registries to org.eclipse.angus.activation and package name from com.sun.activation.registries to org.eclipse.angus.activation.

December 14, 2021 - Angus Activation 1.0.0 Final Release

Initial release of the Eclipse Angus - Angus Activation project. Provides implementation of the Jakarta Activation 2.1 Specification.

July 27, 2021 - Angus Activation inception

As part of breaking tight integration between Jakarta Activation API and the implementation, implementation sources were moved to this new project - Eclipse Angus - and further development continues here. Eclipse Angus is direct accessor of JavaActivation/JakartaActivation.


Download Angus Activation Release

The Angus Activation jar file, which is all most applications will need, is published to the Maven repository and can be included in a project using this Maven dependency:

        <dependencies>
            <dependency>
                <groupId>jakarta.activation</groupId>
                <artifactId>jakarta.activation-api</artifactId>
                <version>${activation-api.version}</version>
            </dependency>
            <dependency>
                <groupId>org.eclipse.angus</groupId>
                <artifactId>angus-activation</artifactId>
                <version>${angus-activation.version}</version>
                <scope>runtime</scope>
            </dependency>
        </dependencies>

You can find all of the Angus Mail jar files in Maven Central.


API Documentation

The Angus Activation API documentation is available here.


Help

You can post questions to the angus-dev mailing list.


Bugs

Angus Activation bugs are tracked in the GitHub Angus Activation project issue tracker.


Development Releases

Snapshot builds of the next version of the Angus Activation under development are published to the Jakarta Sonatype OSS repository. These snapshot builds have received only minimal testing, but may provide previews of bug fixes or new features under development.

For example, you can download the angus-activation.jar file from the Eclipse Angus 2.0.0-SNAPSHOT release here. Be sure to scroll to the bottom and choose the jar file with the most recent time stamp.

You'll need to add the following configuration to your Maven ~/.m2/settings.xml to be able to use these with Maven:

    <profiles>
        <!-- to allow loading Jakarta snapshot artifacts -->
        <profile>
            <id>jakarta-snapshots</id>
            <pluginRepositories>
                <pluginRepository>
                    <id>jakarta-snapshots</id>
                    <name>Jakarta Snapshots</name>
                    <snapshots>
                        <enabled>true</enabled>
                        <updatePolicy>always</updatePolicy>
                        <checksumPolicy>fail</checksumPolicy>
                    </snapshots>
                    <url>https://jakarta.oss.sonatype.org/content/repositories/snapshots/</url>
                    <layout>default</layout>
                </pluginRepository>
            </pluginRepositories>
        </profile>
    </profiles>

And then when you build use mvn -Pjakarta-snapshots ....

If you want the plugin repository to be enabled all the time so you don't need the -P, add:

    <activeProfiles>
        <activeProfile>jakarta-snapshots</activeProfile>
    </activeProfiles>

By contributing to this project, you agree to these additional terms of use, described in CONTRIBUTING.