<?xml version="1.0" encoding="UTF-8"?>
<document>
  <properties>
    <title>Tag Reference</title>
  </properties>
  <body>
    <section name="Tag Reference for @jboss-net">
      <p>Tags for creation of jboss.net specific web service resources</p>
      <div id="source">
        <p>Class Level Tags</p>
        <p>
          <a href="#@jboss-net.web-service (0..1)" title="Will mark this class as a web-service endpoint.">@jboss-net.web-service
            <br/>
          </a>
          <a href="#@jboss-net.authentication (0..1)" title="Enables authentication mapping from web service transport to JBoss security.">@jboss-net.authentication
            <br/>
          </a>
          <a href="#@processEntities (0..1)" title="Includes a transaction handler into the services request/response flow to allow for direct entity bean (de-)serialization.">@processEntities
            <br/>
          </a>
          <a href="#@jboss-net.authorization (0..1)" title="Enables authentication mapping from web service transport to JBoss security.">@jboss-net.authorization
            <br/>
          </a>
          <a href="#@jboss-net.xml-schema (0..1)" title="Will expose the marked class as (de-)serializable xml structure.">@jboss-net.xml-schema
            <br/>
          </a>
        </p>
      </div>
      <div id="source">
        <p>Method Level Tags</p>
        <p>
          <a href="#@jboss-net.web-method (0..1)" title="Will expose the marked method as a web-service operation.">@jboss-net.web-method
            <br/>
          </a>
        </p>
      </div>
      <div id="source">
        <p>Field Level Tags</p>
        <p/>
      </div>
    </section>
    <section name="Tag Usage, Class Level (@jboss-net)">
      <subsection name="@jboss-net.web-service (0..1)">
        <p>Will mark this class as a web-service endpoint.</p>
        <table>
          <tr>
            <th>Parameter</th>
            <th>Type</th>
            <th>Applicability</th>
            <th>Description</th>
            <th>Mandatory</th>
          </tr>
          <tr valign="top">
            <td>urn</td>
            <td>text</td>
            <td/>
            <td>The name of the web service</td>
            <td>
              <b>true</b>
            </td>
          </tr>
          <tr valign="top">
            <td>expose-all</td>
            <td>text</td>
            <td/>
            <td>If present, all methods will be exposed, vs. individually specifying each method to be exposed.</td>
            <td>false</td>
          </tr>
          <tr valign="top">
            <td>scope</td>
            <td>text</td>
            <td/>
            <td>Only useful for stateful session beans. Will set the caching policy of the web service endpoint.</td>
            <td>false</td>
          </tr>
        </table>
      </subsection>
      <subsection name="@jboss-net.authentication (0..1)">
        <p>Enables authentication mapping from web service transport to JBoss security.</p>
        <table>
          <tr>
            <th>Parameter</th>
            <th>Type</th>
            <th>Applicability</th>
            <th>Description</th>
            <th>Mandatory</th>
          </tr>
          <tr valign="top">
            <td>securityDomain</td>
            <td>text</td>
            <td/>
            <td>Use the security domain located in JNDI under java:/jaas/xxx to authenticate against</td>
            <td>
              <b>true</b>
            </td>
          </tr>
        </table>
      </subsection>
      <subsection name="@processEntities (0..1)">
        <p>Includes a transaction handler into the services request/response flow to allow for direct entity bean (de-)serialization.</p>
      </subsection>
      <subsection name="@jboss-net.authorization (0..1)">
        <p>Enables authentication mapping from web service transport to JBoss security.</p>
        <table>
          <tr>
            <th>Parameter</th>
            <th>Type</th>
            <th>Applicability</th>
            <th>Description</th>
            <th>Mandatory</th>
          </tr>
          <tr valign="top">
            <td>securityDomain</td>
            <td>text</td>
            <td/>
            <td>Use the security domain located in JNDI under java:/jaas/xxx to authenticate against</td>
            <td>
              <b>true</b>
            </td>
          </tr>
          <tr valign="top">
            <td>roles-allowed</td>
            <td>text</td>
            <td/>
            <td>list of roles which should be allowed to perform the call</td>
            <td>false</td>
          </tr>
          <tr valign="top">
            <td>roles-denied</td>
            <td>text</td>
            <td/>
            <td>list of roles which should be denied to perform the call</td>
            <td>false</td>
          </tr>
        </table>
      </subsection>
      <subsection name="@jboss-net.xml-schema (0..1)">
        <p>Will expose the marked class as (de-)serializable xml structure.</p>
        <table>
          <tr>
            <th>Parameter</th>
            <th>Type</th>
            <th>Applicability</th>
            <th>Description</th>
            <th>Mandatory</th>
          </tr>
          <tr valign="top">
            <td>urn</td>
            <td>text</td>
            <td/>
            <td>The name of the xml type</td>
            <td>
              <b>true</b>
            </td>
          </tr>
          <tr valign="top">
            <td>data-object</td>
            <td>bool</td>
            <td>Only EntityBeans.</td>
            <td>Whether the entities data-object or the bean itself should be used.</td>
            <td>false</td>
          </tr>
        </table>
      </subsection>
    </section>
    <section name="Tag Usage, Method Level (@jboss-net)">
      <subsection name="@jboss-net.web-method (0..1)">
        <p>Will expose the marked method as a web-service operation.</p>
        <table>
          <tr>
            <th>Parameter</th>
            <th>Type</th>
            <th>Applicability</th>
            <th>Description</th>
            <th>Mandatory</th>
          </tr>
          <tr valign="top">
            <td>returnQName</td>
            <td>text</td>
            <td/>
            <td>Specifies the qname of the result.</td>
            <td>false</td>
          </tr>
        </table>
      </subsection>
    </section>
    <section name="Tag Usage, Field Level (@jboss-net)"/>
  </body>
</document>