| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> |
| <HTML> |
| <HEAD><meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> |
| <title>Service policy</title> |
| <style type="text/css">@import url("../../book.css");</style> |
| <style type="text/css">@import url("../../schema.css");</style> |
| </HEAD> |
| <BODY> |
| <H1 style="text-align:center">Service policy</H1> |
| <p></p> |
| <h6 class="CaptionFigColumn SchemaHeader">Identifier: </h6>org.eclipse.wst.service.policy.servicePolicy<p></p> |
| <h6 class="CaptionFigColumn SchemaHeader">Since: </h6>1.0 |
| <p></p> |
| |
| <h6 class="CaptionFigColumn SchemaHeader">Description: </h6>This extension allows extenders to define service policies.<p> |
| <p></p> |
| <h6 class="CaptionFigColumn SchemaHeader">Configuration Markup:</h6> |
| <p></p> |
| <p class="code SchemaDtd"><!ELEMENT <a name="e.extension">extension</a> (<a href="#e.servicePolicy">servicePolicy</a>+)></p> |
| <p class="code SchemaDtd"><!ATTLIST extension</p> |
| <p class="code SchemaDtdAttlist">point CDATA #REQUIRED<p class="code SchemaDtdAttlist">id CDATA #IMPLIED<p class="code SchemaDtdAttlist">name CDATA #IMPLIED></p> |
| <p></p> |
| <ul class="ConfigMarkupAttlistDesc"> |
| </ul> |
| <br><p class="code SchemaDtd"><!ELEMENT <a name="e.servicePolicy">servicePolicy</a> (<a href="#e.policy">policy</a>? , <a href="#e.enumeration">enumeration</a>? , <a href="#e.loadListener">loadListener</a>? , <a href="#e.enablement">enablement</a>?)+></p> |
| <p></p> |
| <br><br> |
| <p class="code SchemaDtd"><!ELEMENT <a name="e.policy">policy</a> (<a href="#e.descriptor">descriptor</a> , <a href="#e.relationship">relationship</a>* , <a href="#e.state">state</a>*)></p> |
| <p class="code SchemaDtd"><!ATTLIST policy</p> |
| <p class="code SchemaDtdAttlist">parentPolicyId CDATA #IMPLIED<p class="code SchemaDtdAttlist">id CDATA #REQUIRED<p class="code SchemaDtdAttlist">enumListId CDATA #IMPLIED<p class="code SchemaDtdAttlist">defaultEnumId CDATA #IMPLIED<p class="code SchemaDtdAttlist">mutable (true | false) "false"></p> |
| <p></p> |
| <ul class="ConfigMarkupAttlistDesc"> |
| <li><b>parentPolicyId</b> - Specifies the parent policy id for this policy. If this is a root policy this attribute should not be specified.</li> |
| <li><b>id</b> - The unique id for this service policy.</li> |
| <li><b>enumListId</b> - If this policy's state is associated with an enumeration then this attribute specifies the id of this enumeration.</li> |
| <li><b>defaultEnumId</b> - This attribute should only be specified if the enumListId is also specified. It is used to override the default enum value defined by the enumeration.</li> |
| <li><b>mutable</b> - Indicates if this policy has mutable data or not.</li> |
| </ul> |
| <br><p class="code SchemaDtd"><!ELEMENT <a name="e.descriptor">descriptor</a> EMPTY></p> |
| <p class="code SchemaDtd"><!ATTLIST descriptor</p> |
| <p class="code SchemaDtdAttlist">description CDATA #IMPLIED<p class="code SchemaDtdAttlist">shortName CDATA #IMPLIED<p class="code SchemaDtdAttlist">longName CDATA #IMPLIED<p class="code SchemaDtdAttlist">contextHelpId CDATA #IMPLIED<p class="code SchemaDtdAttlist">iconPath CDATA #IMPLIED></p> |
| <p></p> |
| <ul class="ConfigMarkupAttlistDesc"> |
| <li><b>description</b> - A description of this service policy.</li> |
| <li><b>shortName</b> - The short name of this service policy. Note: if a short name is not specified it is defaulted to the value of the long name.</li> |
| <li><b>longName</b> - The long name of this service policy. Note: if a long name attribute is not specified it is defaulted to the shortName value.</li> |
| <li><b>contextHelpId</b> - The context help id for this service policy if it is required.</li> |
| <li><b>iconPath</b> - A plugin relative path to some icon file for this service policy.</li> |
| </ul> |
| <br><p class="code SchemaDtd"><!ELEMENT <a name="e.relationship">relationship</a> (<a href="#e.targetPolicy">targetPolicy</a>+)></p> |
| <p class="code SchemaDtd"><!ATTLIST relationship</p> |
| <p class="code SchemaDtdAttlist">enumList CDATA #REQUIRED></p> |
| <p></p> |
| <p class="ConfigMarkupElementDesc"> |
| Specifies a state relationship between this service policy and the states of other service policies.</p> |
| <br> |
| <ul class="ConfigMarkupAttlistDesc"> |
| <li><b>enumList</b> - </li> |
| </ul> |
| <br><p class="code SchemaDtd"><!ELEMENT <a name="e.targetPolicy">targetPolicy</a> EMPTY></p> |
| <p class="code SchemaDtd"><!ATTLIST targetPolicy</p> |
| <p class="code SchemaDtdAttlist">id CDATA #REQUIRED<p class="code SchemaDtdAttlist">itemList CDATA #REQUIRED></p> |
| <p></p> |
| <ul class="ConfigMarkupAttlistDesc"> |
| <li><b>id</b> - </li> |
| <li><b>itemList</b> - </li> |
| </ul> |
| <br><p class="code SchemaDtd"><!ELEMENT <a name="e.enumeration">enumeration</a> (<a href="#e.item">item</a>+)></p> |
| <p class="code SchemaDtd"><!ATTLIST enumeration</p> |
| <p class="code SchemaDtdAttlist">default CDATA #IMPLIED<p class="code SchemaDtdAttlist">id CDATA #REQUIRED></p> |
| <p></p> |
| <ul class="ConfigMarkupAttlistDesc"> |
| <li><b>default</b> - </li> |
| <li><b>id</b> - </li> |
| </ul> |
| <br><p class="code SchemaDtd"><!ELEMENT <a name="e.item">item</a> EMPTY></p> |
| <p class="code SchemaDtd"><!ATTLIST item</p> |
| <p class="code SchemaDtdAttlist">id CDATA #REQUIRED<p class="code SchemaDtdAttlist">shortName CDATA #IMPLIED<p class="code SchemaDtdAttlist">longName CDATA #IMPLIED></p> |
| <p></p> |
| <ul class="ConfigMarkupAttlistDesc"> |
| <li><b>id</b> - </li> |
| <li><b>shortName</b> - </li> |
| <li><b>longName</b> - </li> |
| </ul> |
| <br><p class="code SchemaDtd"><!ELEMENT <a name="e.loadListener">loadListener</a> EMPTY></p> |
| <p class="code SchemaDtd"><!ATTLIST loadListener</p> |
| <p class="code SchemaDtdAttlist">class CDATA #IMPLIED></p> |
| <p></p> |
| <ul class="ConfigMarkupAttlistDesc"> |
| <li><b>class</b> - A class that implements the IPolicyPlatformLoadListener interface. The load method of this class will be called when the ServicePolicy framework is first loaded.</li> |
| </ul> |
| <br><p class="code SchemaDtd"><!ELEMENT <a name="e.state">state</a> EMPTY></p> |
| <p class="code SchemaDtd"><!ATTLIST state</p> |
| <p class="code SchemaDtdAttlist">key CDATA #REQUIRED<p class="code SchemaDtdAttlist">value CDATA #REQUIRED></p> |
| <p></p> |
| <p class="ConfigMarkupElementDesc"> |
| This element allows the extender to define state data for this policy.</p> |
| <br> |
| <ul class="ConfigMarkupAttlistDesc"> |
| <li><b>key</b> - The key for this state data.</li> |
| <li><b>value</b> - The value of this state data.</li> |
| </ul> |
| <br><p class="code SchemaDtd"><!ELEMENT <a name="e.enablement">enablement</a> (<a href="#e.not">not</a> , <a href="#e.and">and</a> , <a href="#e.or">or</a> , <a href="#e.instanceof">instanceof</a> , <a href="#e.test">test</a> , <a href="#e.systemTest">systemTest</a> , <a href="#e.equals">equals</a> , <a href="#e.count">count</a> , <a href="#e.with">with</a> , <a href="#e.resolve">resolve</a> , <a href="#e.adapt">adapt</a> , <a href="#e.iterate">iterate</a> , <a href="#e.reference">reference</a>)*></p> |
| <p></p> |
| <p class="ConfigMarkupElementDesc"> |
| A generic root element. The element can be used inside an extension point to define its enablement expression. |
| The children of an enablement expression are combined using the and operator.</p> |
| <br><br> |
| <p class="code SchemaDtd"><!ELEMENT <a name="e.not">not</a> (<a href="#e.not">not</a> | <a href="#e.and">and</a> | <a href="#e.or">or</a> | <a href="#e.instanceof">instanceof</a> | <a href="#e.test">test</a> | <a href="#e.systemTest">systemTest</a> | <a href="#e.equals">equals</a> | <a href="#e.count">count</a> | <a href="#e.with">with</a> | <a href="#e.resolve">resolve</a> | <a href="#e.adapt">adapt</a> | <a href="#e.iterate">iterate</a> | <a href="#e.reference">reference</a>)></p> |
| <p></p> |
| <p class="ConfigMarkupElementDesc"> |
| This element represent a NOT operation on the result of evaluating it's sub-element expression.</p> |
| <br><br> |
| <p class="code SchemaDtd"><!ELEMENT <a name="e.and">and</a> (<a href="#e.not">not</a> , <a href="#e.and">and</a> , <a href="#e.or">or</a> , <a href="#e.instanceof">instanceof</a> , <a href="#e.test">test</a> , <a href="#e.systemTest">systemTest</a> , <a href="#e.equals">equals</a> , <a href="#e.count">count</a> , <a href="#e.with">with</a> , <a href="#e.resolve">resolve</a> , <a href="#e.adapt">adapt</a> , <a href="#e.iterate">iterate</a> , <a href="#e.reference">reference</a>)*></p> |
| <p></p> |
| <p class="ConfigMarkupElementDesc"> |
| This element represent an AND operation on the result of evaluating all it's sub-elements expressions.</p> |
| <br><br> |
| <p class="code SchemaDtd"><!ELEMENT <a name="e.or">or</a> (<a href="#e.not">not</a> , <a href="#e.and">and</a> , <a href="#e.or">or</a> , <a href="#e.instanceof">instanceof</a> , <a href="#e.test">test</a> , <a href="#e.systemTest">systemTest</a> , <a href="#e.equals">equals</a> , <a href="#e.count">count</a> , <a href="#e.with">with</a> , <a href="#e.resolve">resolve</a> , <a href="#e.adapt">adapt</a> , <a href="#e.iterate">iterate</a> , <a href="#e.reference">reference</a>)*></p> |
| <p></p> |
| <p class="ConfigMarkupElementDesc"> |
| This element represent an OR operation on the result of evaluating all it's sub-element expressions.</p> |
| <br><br> |
| <p class="code SchemaDtd"><!ELEMENT <a name="e.instanceof">instanceof</a> EMPTY></p> |
| <p class="code SchemaDtd"><!ATTLIST instanceof</p> |
| <p class="code SchemaDtdAttlist">value CDATA #REQUIRED></p> |
| <p></p> |
| <p class="ConfigMarkupElementDesc"> |
| This element is used to perform an instanceof check of the object in focus. The expression returns |
| EvaluationResult.TRUE if the object's type is a sub type of the type specified by the attribute value. |
| Otherwise EvaluationResult.FALSE is returned.</p> |
| <br> |
| <ul class="ConfigMarkupAttlistDesc"> |
| <li><b>value</b> - a fully qualified name of a class or interface.</li> |
| </ul> |
| <br><p class="code SchemaDtd"><!ELEMENT <a name="e.test">test</a> EMPTY></p> |
| <p class="code SchemaDtd"><!ATTLIST test</p> |
| <p class="code SchemaDtdAttlist">property CDATA #REQUIRED<p class="code SchemaDtdAttlist">args CDATA #IMPLIED<p class="code SchemaDtdAttlist">value CDATA #IMPLIED<p class="code SchemaDtdAttlist">forcePluginActivation (true | false) ></p> |
| <p></p> |
| <p class="ConfigMarkupElementDesc"> |
| This element is used to evaluate the property state of the object in focus. The set of |
| testable properties can be extended using the propery tester extension point. The test |
| expression returns EvaluationResult.NOT_LOADED if the property tester doing the actual |
| testing isn't loaded yet and the attribute forcePluginActivation is set to false. |
| If forcePluginActivation is set to true and the evaluation context used to evaluate |
| this expression support plug-in activation then evaluating the property will result in |
| activating the plug-in defining the tester.</p> |
| <br> |
| <ul class="ConfigMarkupAttlistDesc"> |
| <li><b>property</b> - the name of an object's property to test.</li> |
| <li><b>args</b> - additional arguments passed to the property tester. Multiple arguments are seperated |
| by commas. Each individual argument is converted into a Java base type using the same |
| rules as defined for the value attribute of the test expression.</li> |
| <li><b>value</b> - the expected value of the property. Can be omitted if the property |
| is a boolean property. The test expression is supposed to return |
| EvaluationResult.TRUE if the property matches the value and EvaluationResult.FALSE |
| otherwise. The value attribute is converted into a Java base type using the following |
| rules: |
| <ul> |
| <li>the string "true" is converted into Boolean.TRUE</li> |
| <li>the string "false" is converted into Boolean.FALSE</li> |
| <li>if the string contains a dot then the interpreter tries to convert |
| the value into a Float object. If this fails the string is treated as a |
| java.lang.String</li> |
| <li>if the string only consists of numbers then the interpreter |
| converts the value in an Integer object.</li> |
| <li>in all other cases the string is treated as a java.lang.String</li> |
| <li>the conversion of the string into a Boolean, Float, or Integer can |
| be suppressed by surrounding the string with single quotes. For |
| example, the attribute value="'true'" is converted into the |
| string "true"</li> |
| </ul></li> |
| <li><b>forcePluginActivation</b> - a flag indicating whether the plug-in contributing the property tester |
| should be loaded if necessary. As such, this flag should be used judiciously, |
| in order to avoid unnecessary plug-in activations. Most clients should avoid |
| setting this flag to true. This flag is only honored if the evaluation context |
| used to evaluate this expression allows plug-in activation. Otherwise the flag |
| is ignored and no plug-in loading takes place.</li> |
| </ul> |
| <br><p class="code SchemaDtd"><!ELEMENT <a name="e.systemTest">systemTest</a> EMPTY></p> |
| <p class="code SchemaDtd"><!ATTLIST systemTest</p> |
| <p class="code SchemaDtdAttlist">property CDATA #REQUIRED<p class="code SchemaDtdAttlist">value CDATA #REQUIRED></p> |
| <p></p> |
| <p class="ConfigMarkupElementDesc"> |
| Tests a system property by calling the System.getProperty method and compares the result |
| with the value specified through the value attribute.</p> |
| <br> |
| <ul class="ConfigMarkupAttlistDesc"> |
| <li><b>property</b> - the name of an system property to test.</li> |
| <li><b>value</b> - the expected value of the property. The value is interpreted as a string value.</li> |
| </ul> |
| <br><p class="code SchemaDtd"><!ELEMENT <a name="e.equals">equals</a> EMPTY></p> |
| <p class="code SchemaDtd"><!ATTLIST equals</p> |
| <p class="code SchemaDtdAttlist">value CDATA #REQUIRED></p> |
| <p></p> |
| <p class="ConfigMarkupElementDesc"> |
| This element is used to perform an equals check of the object in focus. The expression returns |
| EvaluationResult.TRUE if the object is equal to the value provided by the attribute value. Otherwise |
| EvaluationResult.FALSE is returned.</p> |
| <br> |
| <ul class="ConfigMarkupAttlistDesc"> |
| <li><b>value</b> - the expected value. The value provided as a string is converted into |
| a Java base type using the same rules as for the value attribute of the test expression.</li> |
| </ul> |
| <br><p class="code SchemaDtd"><!ELEMENT <a name="e.count">count</a> EMPTY></p> |
| <p class="code SchemaDtd"><!ATTLIST count</p> |
| <p class="code SchemaDtdAttlist">value CDATA #REQUIRED></p> |
| <p></p> |
| <p class="ConfigMarkupElementDesc"> |
| This element is used to test the number of elements in a collection.</p> |
| <br> |
| <ul class="ConfigMarkupAttlistDesc"> |
| <li><b>value</b> - an expression to specify the number of elements in a list. Following wildcard |
| characters can be used: |
| <dl> |
| <dt>*</dt> <dd>any number of elements</dd> |
| <dt>?</dt> <dd>no elements or one element</dd> |
| <dt>+</dt> <dd>one or more elements</dd> |
| <dt>!</dt> <dd>no elements</dd> |
| <dt>integer value</dt> <dd>the list must contain the exact number of elements</dd> |
| </dl></li> |
| </ul> |
| <br><p class="code SchemaDtd"><!ELEMENT <a name="e.with">with</a> (<a href="#e.not">not</a> , <a href="#e.and">and</a> , <a href="#e.or">or</a> , <a href="#e.instanceof">instanceof</a> , <a href="#e.test">test</a> , <a href="#e.systemTest">systemTest</a> , <a href="#e.equals">equals</a> , <a href="#e.count">count</a> , <a href="#e.with">with</a> , <a href="#e.resolve">resolve</a> , <a href="#e.adapt">adapt</a> , <a href="#e.iterate">iterate</a> , <a href="#e.reference">reference</a>)*></p> |
| <p class="code SchemaDtd"><!ATTLIST with</p> |
| <p class="code SchemaDtdAttlist">variable CDATA #REQUIRED></p> |
| <p></p> |
| <p class="ConfigMarkupElementDesc"> |
| This element changes the object to be inspected for all its child element to the object |
| referenced by the given variable. If the variable can not be resolved then the expression |
| will throw a ExpressionException when evaluating it. The children of a with expression |
| are combined using the and operator.</p> |
| <br> |
| <ul class="ConfigMarkupAttlistDesc"> |
| <li><b>variable</b> - the name of the variable to be used for further inspection. It is up to the evaluator |
| of an extension point to provide the variable in the variable pool.</li> |
| </ul> |
| <br><p class="code SchemaDtd"><!ELEMENT <a name="e.resolve">resolve</a> (<a href="#e.not">not</a> , <a href="#e.and">and</a> , <a href="#e.or">or</a> , <a href="#e.instanceof">instanceof</a> , <a href="#e.test">test</a> , <a href="#e.systemTest">systemTest</a> , <a href="#e.equals">equals</a> , <a href="#e.count">count</a> , <a href="#e.with">with</a> , <a href="#e.resolve">resolve</a> , <a href="#e.adapt">adapt</a> , <a href="#e.iterate">iterate</a> , <a href="#e.reference">reference</a>)*></p> |
| <p class="code SchemaDtd"><!ATTLIST resolve</p> |
| <p class="code SchemaDtdAttlist">variable CDATA #REQUIRED<p class="code SchemaDtdAttlist">args CDATA #IMPLIED></p> |
| <p></p> |
| <p class="ConfigMarkupElementDesc"> |
| This element changes the object to be inspected for all its child element to the object |
| referenced by the given variable. If the variable can not be resolved then the expression |
| will throw a ExpressionException when evaluating it. The children of a with expression |
| are combined using the and operator.</p> |
| <br> |
| <ul class="ConfigMarkupAttlistDesc"> |
| <li><b>variable</b> - the name of the variable to be resolved. This variable is then used as the object in focus |
| for child element evaluation. It is up to the evaluator of an extension point to provide a |
| corresponding variable resolver (see IVariableResolver) through the evaluation context passed |
| to the root expression element when evaluating the expression.</li> |
| <li><b>args</b> - additional arguments passed to the variable resolver. Multiple arguments are seperated |
| by commas. Each individual argument is converted into a Java base type using the same |
| rules as defined for the value attribute of the test expression.</li> |
| </ul> |
| <br><p class="code SchemaDtd"><!ELEMENT <a name="e.adapt">adapt</a> (<a href="#e.not">not</a> , <a href="#e.and">and</a> , <a href="#e.or">or</a> , <a href="#e.instanceof">instanceof</a> , <a href="#e.test">test</a> , <a href="#e.systemTest">systemTest</a> , <a href="#e.equals">equals</a> , <a href="#e.count">count</a> , <a href="#e.with">with</a> , <a href="#e.resolve">resolve</a> , <a href="#e.adapt">adapt</a> , <a href="#e.iterate">iterate</a> , <a href="#e.reference">reference</a>)*></p> |
| <p class="code SchemaDtd"><!ATTLIST adapt</p> |
| <p class="code SchemaDtdAttlist">type CDATA #REQUIRED></p> |
| <p></p> |
| <p class="ConfigMarkupElementDesc"> |
| This element is used to adapt the object in focus to the type specified by the attribute |
| type. The expression returns not loaded if either the adapter or the type referenced isn't |
| loaded yet. It throws a ExpressionException during evaluation if the type name doesn't exist |
| at all. The children of an adapt expression are combined using the and operator.</p> |
| <br> |
| <ul class="ConfigMarkupAttlistDesc"> |
| <li><b>type</b> - the type to which the object in focus is to be adapted.</li> |
| </ul> |
| <br><p class="code SchemaDtd"><!ELEMENT <a name="e.iterate">iterate</a> (<a href="#e.not">not</a> , <a href="#e.and">and</a> , <a href="#e.or">or</a> , <a href="#e.instanceof">instanceof</a> , <a href="#e.test">test</a> , <a href="#e.systemTest">systemTest</a> , <a href="#e.equals">equals</a> , <a href="#e.count">count</a> , <a href="#e.with">with</a> , <a href="#e.resolve">resolve</a> , <a href="#e.adapt">adapt</a> , <a href="#e.iterate">iterate</a> , <a href="#e.reference">reference</a>)*></p> |
| <p class="code SchemaDtd"><!ATTLIST iterate</p> |
| <p class="code SchemaDtdAttlist">operator (or|and) <p class="code SchemaDtdAttlist">ifEmpty (true | false) ></p> |
| <p></p> |
| <p class="ConfigMarkupElementDesc"> |
| This element is used to iterate over a variable that is of type java.util.Collection. If |
| the object in focus is not of type java.util.Collection then an ExpressionException will |
| be thrown while evaluating the expression.</p> |
| <br> |
| <ul class="ConfigMarkupAttlistDesc"> |
| <li><b>operator</b> - either "and" or "or". The operator defines how the child |
| elements will be combined. If not specified, "and" will be used.</li> |
| <li><b>ifEmpty</b> - the value return from the iterate expression if the collection is empty. If |
| not specified then true is returned when the operator equals "and" |
| and false is return if the operator equals "or".</li> |
| </ul> |
| <br><p class="code SchemaDtd"><!ELEMENT <a name="e.reference">reference</a> EMPTY></p> |
| <p class="code SchemaDtd"><!ATTLIST reference</p> |
| <p class="code SchemaDtdAttlist">definitionId CDATA #REQUIRED></p> |
| <p></p> |
| <p class="ConfigMarkupElementDesc"> |
| This element is used to reference an expression from the <b>org.eclipse.core.expressions.definitions</b> extension point. The expression definition will be evaluated within the current expression element using the current evaluation context.</p> |
| <br> |
| <ul class="ConfigMarkupAttlistDesc"> |
| <li><b>definitionId</b> - The unique id of an expression from <b>org.eclipse.core.expressions.definitions</b>.</li> |
| </ul> |
| <br><h6 class="CaptionFigColumn SchemaHeader">Examples: </h6>[Enter extension point usage example here.] |
| <p></p> |
| |
| <h6 class="CaptionFigColumn SchemaHeader">Supplied Implementation: </h6>[Enter information about supplied implementation of this extension point.] |
| <p></p> |
| |
| <br> |
| <p class="note SchemaCopyright"> |
| </p> |
| </BODY> |
| </HTML> |