Functions

Since: 2.1.0.

Description: Each extension provides one or more service callbacks functions. For each function, the service UI plug-in will add a button for invoking the function, and a label that identifies the function, to its user interface. The UI plug-in also provides an input field and a result field that are shared between all function. The function takes a long as its input, and returns a long as its output.

Configuration Markup:

   <!ELEMENT extension (function+)>

   <!ATTLIST extension
     point CDATA #REQUIRED
     id    CDATA #IMPLIED
     name  CDATA #IMPLIED
   >

• point - The extension-point of this extension.
• id - Extension identifier.
• name - Name of this extension.

   <!ELEMENT function EMPTY>

   <!ATTLIST function
     name     CDATA #IMPLIED
     class    CDATA #IMPLIED
     constant CDATA #IMPLIED
   >

• name - The name of the function.
• class - The specific class implementing the function.
• constant - A constant parameter used in the computation of the function. This constant may be interpreted differently by different extension members. For example, in a member that provides an exponentiation function, the constant is interpreted as the exponent.

   <!-- Extend the functions of the host ... -->
   <extension
         id="service.exponentiation"
         name="ExponentiationFunctions"
         point="com.bolour.sample.eclipse.service.ui.functions">
      <service
        constant="3"
        name="CUBE"
        class="com.bolour.sample.eclipse.exponentiation.Exponentiation"/>
      <service
        constant="4"
        name="FOURTH POWER"
        class="com.bolour.sample.eclipse.exponentiation.Exponentiation"/>
   </extension>         

API Information: Extension callback objects implement the com.bolour.sample.eclipse.service.ui.IFunction interface.

Supplied Implementation: An example implementation is provided in plug-in com.bolour.sample.eclipse.service.exponentiation.