| <!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>Contextual Symbol Factory</title> |
| <style>@import url("../../book.css");</style> |
| <style>@import url("../../schema.css");</style> |
| </HEAD> |
| <BODY> |
| <H1><CENTER>Contextual Symbol Factory</CENTER></H1> |
| <p></p> |
| <h6 class=CaptionFigColumn id=header>Identifier: </h6>org.eclipse.jst.jsf.context.symbol.contextSymbolFactory<p></p> |
| <h6 class=CaptionFigColumn id=header>Since: </h6>1.5 |
| <p></p> |
| |
| <p> |
| <h6 class=CaptionFigColumn id=header>Description: </h6>The context symbol factory allows a symbol factory with a specific id to be registered to create symbols in a particular context. Clients wishing to delegate symbol construction in a particular context may then request the symbol factory based on its id. |
| |
| To get a map of registered symbol factories keyed by id, call SymbolsPlugin.getSymbolFactories(). |
| |
| The most common use of this extension point is by the JSPModelProcessor. By decorating a tag attribute with meta-data pointing to a context symbol factory with a particular id, the JSP model processor will call that symbol factory to create a symbol for that tag. |
| |
| See developer docs on decorating variable contributing tags for more information.</p> |
| <p><h6 class=CaptionFigColumn id=header>Configuration Markup:</h6></p> |
| <p class=code id=dtd><!ELEMENT <a name="e.extension">extension</a> (<a href="#e.contextSymbolFactory">contextSymbolFactory</a>)></p> |
| <p class=code id=dtd><!ATTLIST extension</p> |
| <p class=code id=dtdAttlist>point CDATA #REQUIRED<p class=code id=dtdAttlist>id CDATA #IMPLIED<p class=code id=dtdAttlist>name CDATA #IMPLIED></p> |
| <p></p> |
| <ul class=ConfigMarkup id=attlistDesc> |
| </ul> |
| <br><p class=code id=dtd><!ELEMENT <a name="e.contextSymbolFactory">contextSymbolFactory</a> EMPTY></p> |
| <p class=code id=dtd><!ATTLIST contextSymbolFactory</p> |
| <p class=code id=dtdAttlist>factory CDATA #REQUIRED<p class=code id=dtdAttlist>factoryId CDATA #REQUIRED></p> |
| <p></p> |
| <p class=ConfigMarkup id=elementDesc> |
| The context symbol factory description.</p> |
| <br> |
| <ul class=ConfigMarkup id=attlistDesc> |
| <li><b>factory</b> - An instance of AbstractContextSymbolFactory that implements the context symbol factory.</li> |
| <li><b>factoryId</b> - The id that will be used to uniquely identify this factory in meta-data or elsewhere.</li> |
| </ul> |
| <br><h6 class=CaptionFigColumn id=header>Examples: </h6><p>The following example creates a symbol factory for creating symbols.</p> |
| |
| <p> |
| <pre> |
| <p class=code id=tag><extension |
| point=<p class=code id=cstring>"org.eclipse.jst.jsf.context.symbol.contextSymbolFactory"</p><p class=code id=tag>></p> |
| <p class=code id=tag><contextSymbolFactory |
| factory=<p class=code id=cstring>"org.eclipse.jst.jsf.designtime.internal.jsp.JSPDefaultSymbolFactory"</p><p class=code id=tag> |
| factoryId=<p class=code id=cstring>"org.eclipse.jst.jsf.designtime.core.loadBundle"</p><p class=code id=tag>/></p> |
| <p class=code id=tag></extension></p> |
| </pre> |
| </p> |
| |
| <p>When the symbol factory <i>org.eclipse.jst.jsf.designtime.core.loadBundle</i> is requested, an instance of JSPDefaultSymbolFactory will be constructed.</p> |
| <p></p> |
| |
| <br> |
| <p class=note id=copyright> |
| Copyright 2006 Oracle |
| All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html |
| <p></p> |
| |
| </p> |
| </BODY> |
| </HTML> |