The Coherence Eclipse Plugin provides various features to help developer productivity when working with Coherence.
Currently this plugin supports the following features:
Coherence POF Plugin
- Provides a development time instrumentation of classes with thePortableType
annotation to generate consistent (and correct) implementations ofEvolvable
POF serialization methods. This development time plugin can be used in conjunction with the POF Maven Plugin which instruments classes at project build time. See the official Portable Type documentation for more details on writing portable types in Coherence.
If you are using Eclipse Marketplace Client, then you can use either of the following methods:
-
Drag the following to your running Eclipse workspace
-
Open Eclipse Marketplace Client and search for Coherence, then choose Install on the Coherence Eclipse Plugin 1.0.0. Accept the terms and conditions and click Finish.
To install the plugin carry out the following:
-
Choose Help -> Install New Software
-
Click on Add button on the right
-
Choose a name such as
Coherence Eclipse Plugin Update Site
-
Enter the location of the Plugin Repository
https://oracle.github.io/coherence-eclipse-plugin/eclipse/1.0.0
and click Add. -
Select the
Coherence Eclipse Plugin
displayed in the list and click Next, then Next -
Accept the license terms and click Finish
-
Click Restart Now to restart Eclipse
Note: You can use the example project here to test the plugin.
-
Right-click on your open project
-
Select Configure then Enable Coherence POF Plugin
-
Right-click on your open project
-
Select Configure then Disable Coherence POF Plugin
When you build your project, for any Java classes that use the @PortableType
annotation
you will see an Info message in the Problems
tab saying the class was instrumented.
A message indicating the class was not instrumented can indicate that it has already been instrumented
or is ignored because is does not implement the PortableType
annotation.
-
Choose Help -> Install New Software
-
Click on What is already installed link
-
Search for Coherence and select Coherence Eclipse Plugin
-
Click Un-install then Finish
-
Click Restart Now to restart Eclipse
You must have:
- JDK1.8
- Maven 3.6.3+
- Minimum Eclipse version 2020-03
-
Clone the repository
git clone https://github.com/oracle/coherence-eclipse-plugin.git
-
Build the plugin
cd coherence-eclipse-plugin mvn clean install
This will generate a zip file called ./coherence.eclipse.plugin.repository/target/coherence-eclipse-plugin-repository-1.0.0-SNAPSHOT.zip
-
Choose Help -> Install New Software
-
Click on Add button on the right
-
Choose a name such as Coherence Local
-
Click on Archive and choose the zip file mentioned above and click Add
-
Select the Coherence Eclipse Plugin displayed in the list and click Next, then Next
-
Accept the license terms and click Finish
-
You may receive a warning that the plugin is unsigned. Choose Install Anyway
-
Click Restart Now to restart Eclipse
To import the plugin project into your Eclipse IDE, carry out the following:
-
Clone the repository using:
git clone https://github.com/oracle/coherence-eclipse-plugin.git
-
Open Eclipse
-
Choose File -> Open Projects from Filesystem
-
Choose Directory and select the coherence-eclipse-plugin project you cloned, then click
Done
-
Ensure you only select the
coherence-eclipse-plugin/coherence.eclipse.plugin
as shown below:
Note: Ignore any errors from the
pom.xml
file as this is only used for a Maven build.
This project welcomes contributions from the community. Before submitting a pull request, please review our contribution guide
Please consult the security guide for our responsible security vulnerability disclosure process
Copyright (c) 2020, 2023 Oracle and/or its affiliates.
Released under the Universal Permissive License v1.0 as shown at https://oss.oracle.com/licenses/upl/.