Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

Difference between revisions of "Object Teams Quick-Start"

(OT/Equinox Hello World Example)
Line 77: Line 77:
 
   <li>'''Overview''' tab: check "''Activate this plug-in ...''" and "''This plug-in is a singleton''" </li>
 
   <li>'''Overview''' tab: check "''Activate this plug-in ...''" and "''This plug-in is a singleton''" </li>
 
   <li>'''Dependencies''' tab: add <code>org.eclipse.ui.workbench</code> and <code>org.objectteams.otequinox</code> as required plug-ins </li>
 
   <li>'''Dependencies''' tab: add <code>org.eclipse.ui.workbench</code> and <code>org.objectteams.otequinox</code> as required plug-ins </li>
   <li>'''Extensions''' tab: add <code>org.objectteams.otequinox.aspectBindings</code> extension
+
   <li>'''Extensions''' tab: add <code>org.eclipse.objectteams.otequinox.aspectBindings</code> extension
 
   <ol>
 
   <ol>
 
     <li>For the '''basePlugin''' entry, enter the plug-in id <code>org.eclipse.ui.workbench</code></li>
 
     <li>For the '''basePlugin''' entry, enter the plug-in id <code>org.eclipse.ui.workbench</code></li>
Line 113: Line 113:
  
 
[[Image:Object_Teams_Quick_Start_About.png]]
 
[[Image:Object_Teams_Quick_Start_About.png]]
 +
 
=What's Next?=
 
=What's Next?=
 
Now, that you've successfully applied the fundamental concepts and mechanisms of [[OTJ|OT/J]] and [[:Category:OTEquinox|OT/Equinox]], you are ready to find out, that Object Teams is not just about replacing individual methods, but has a lot more to offer for helping you create '''architectures''', that are '''well modularized''' and '''scalable''', with exactly that balance between '''encapsulation''' and '''flexibility''' you need to develop and maintain your projects.
 
Now, that you've successfully applied the fundamental concepts and mechanisms of [[OTJ|OT/J]] and [[:Category:OTEquinox|OT/Equinox]], you are ready to find out, that Object Teams is not just about replacing individual methods, but has a lot more to offer for helping you create '''architectures''', that are '''well modularized''' and '''scalable''', with exactly that balance between '''encapsulation''' and '''flexibility''' you need to develop and maintain your projects.
  
 
[[Category:Object Teams|*]]
 
[[Category:Object Teams|*]]

Revision as of 09:37, 7 July 2010

Idea.png
This step-by-step Quick-Start guide should get you started with Object Teams in less than 15 minutes.


Installation of the OTDT (development environment)

Note that previous releases are still served from www.objectteams.org

  1. Prerequisites: Eclipse running on a JRE 1.5 or greater
    1. Tip: set -Xmx512m in eclipse.ini
  2. Fire up Eclipse and add our update site
  3. Select "Object Teams Development Tooling", install it and restart
    1. Ensure that Java compiler compliance level is set to 1.5 or greater
    2. Tip: Enable "Java Type Indicator" under Preferences->General->Appearance->Label Decorations

OT/J Hello World Example

Note: throughout this site links like OTJLD §0 refer to matching paragraphs in the OT/J Language Definition.

This most simple example of an OT/J Application demonstrates how easy it is to intercept a (private!) base method and adapt its behavior in a separate role class. The example makes use of role binding (OTJLD §2, replace callin (OTJLD §4), decapsulation (OTJLD §4.6) and unanticipated team activation (OTJLD §5.5).

  1. Start the New Project Wizard, select "Object Teams Project" and proceed as usual
  2. Create a new class core.Main with the following content:
    package core;
    public class Main {
        public static void main(String[] args) {
            sayHello();
        }
        private static void sayHello() {
            System.out.println("Hello World!");
        }
    }
  3. Create a run configuration of type "Java Application"
    1. Select core.Main as the main class
  4. Run this configuration. The console output should look like:
    Hello World!
  5. Create a new Team class aspect.MyTeam (e.g., using the New Team wizard) with the following content:
    package aspect;
     
    import base core.Main;
     
    public team class MyTeam {
        protected class MyRole playedBy Main {
            callin static void sayMore() {
                System.out.println("callin begins ...");
                base.sayMore();
                System.out.println("callin ends ...");
            }
            sayMore <- replace sayHello;
        }
    }
  6. Open the previously created run configuration
    1. On the JRE tab, make sure that "Enable OTRE" is checked (is default for an Object Teams Project)
    2. On the Team Activation tab, add aspect.MyTeam
  7. Run the configuration again. The console output should now look like:
    callin begins ...
    Hello World!
    callin ends ...

OT/Equinox Hello World Example

This example shows a simple adaptation of an existing Eclipse plug-in using the aspect binding concept of OT/Equinox.

  1. Start the New Project Wizard, select "Object Teams Plug-in Project"
    1. Enter project name and select "Eclipse version 3.x" (matching your Eclipse version) as target platform, click "Next"
    2. Uncheck all of the plug-in options and choose not to create an RCP application
    3. Click "Finish"
  2. Configure the plug-in with the Plug-in Manifest Editor
    1. Overview tab: check "Activate this plug-in ..." and "This plug-in is a singleton"
    2. Dependencies tab: add org.eclipse.ui.workbench and org.objectteams.otequinox as required plug-ins
    3. Extensions tab: add org.eclipse.objectteams.otequinox.aspectBindings extension
      1. For the basePlugin entry, enter the plug-in id org.eclipse.ui.workbench
      2. For the team entry, enter a class name of aspect.MyTeam and set activation to "ALL_THREADS"
      3. Save
  3. Create a new Team class aspect.MyTeam (e.g., using the New Team wizard) with the following content:
    package aspect;
     
    import base org.eclipse.ui.internal.about.AboutItem;
     
    @SuppressWarnings("restriction")
    public team class MyTeam {
        protected class MyRole playedBy AboutItem {
            callin String getText() {
                StringBuffer sb = new StringBuffer();
                sb.append("########\n");
                sb.append("## Test ##\n");
                sb.append("########\n");
                sb.append(base.getText());
                return sb.toString();
            }
            getText <- replace getText;
        }
    }
  4. Create a run configuration of type "Eclipse Application"
    1. On the Main tab, check "Enable OT/Equinox"
    2. (optional) On the Plug-ins tab, switch to "plug-ins selected below only", deselect all, manually select the OT aspect plugin you created and click "Add Required Plug-ins"
  5. Run this configuration. In the started runtime workbench open the Help->About Eclipse SDK dialog. It should show the additional text from the callin method like this:

Object Teams Quick Start About.png

What's Next?

Now, that you've successfully applied the fundamental concepts and mechanisms of OT/J and OT/Equinox, you are ready to find out, that Object Teams is not just about replacing individual methods, but has a lot more to offer for helping you create architectures, that are well modularized and scalable, with exactly that balance between encapsulation and flexibility you need to develop and maintain your projects.

Back to the top