• Overview
• Installation
• Using the Plugin
• Example Projects
• Development
  • Build the Plugin
  • Install the Plugin Manually
  • Open The Plugin Project

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 the PortableType annotation to generate consistent (and correct) implementations of Evolvable 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:

1. Drag the following to your running Eclipse workspace

   

2. 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:

1. Choose Help -> Install New Software

2. Click on Add button on the right

3. Choose a name such as Coherence Eclipse Plugin Update Site

4. Enter the location of the Plugin Repository https://oracle.github.io/coherence-eclipse-plugin/eclipse/1.0.0 and click Add.

5. Select the Coherence Eclipse Plugin displayed in the list and click Next, then Next

6. Accept the license terms and click Finish

7. Click Restart Now to restart Eclipse

Note: You can use the example project here to test the plugin.

1. Right-click on your open project

2. Select Configure then Enable Coherence POF Plugin

1. Right-click on your open project

2. 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.

1. Choose Help -> Install New Software

2. Click on What is already installed link

3. Search for Coherence and select Coherence Eclipse Plugin

4. Click Un-install then Finish

5. Click Restart Now to restart Eclipse

You must have:

• JDK1.8
• Maven 3.6.3+
• Minimum Eclipse version 2020-03

1. Clone the repository

   git clone https://github.com/oracle/coherence-eclipse-plugin.git

2. 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

1. Choose Help -> Install New Software

2. Click on Add button on the right

3. Choose a name such as Coherence Local

4. Click on Archive and choose the zip file mentioned above and click Add

5. Select the Coherence Eclipse Plugin displayed in the list and click Next, then Next

6. Accept the license terms and click Finish

7. You may receive a warning that the plugin is unsigned. Choose Install Anyway

8. Click Restart Now to restart Eclipse

To import the plugin project into your Eclipse IDE, carry out the following:

1. Clone the repository using:

   git clone https://github.com/oracle/coherence-eclipse-plugin.git

2. Open Eclipse

3. Choose File -> Open Projects from Filesystem

4. Choose Directory and select the coherence-eclipse-plugin project you cloned, then click Done

5. 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/.