La programmazione basata su annotazioni è un meccanismo estendibile per la generazione di risorse utente di applicazione, la creazione di package per l'applicazione e la preparazione dell'applicazione per l'esecuzione.
La programmazione basata sulle annotazioni presenta un insieme di tag e un meccanismo di elaborazione che consentono di incorporare metadati aggiuntivi nel codice sorgente Java.
L'applicazione utilizza quindi questi metadati aggiuntivi per acquisire le risorse utente richieste per eseguire l'applicazione in un ambiente J2EE.
Obiettivo della programmazione basata su annotazioni
L'obiettivo della programmazione basata su annotazioni è ridurre il numero di risorse utente da creare e mantenere, semplificando il processo di sviluppo.
Ad esempio, si consideri un EJB di sessione stateless. Con la programmazione basata su annotazioni, è sufficiente creare un singolo file sorgente Java contenente la logica di implementazione bean e alcuni tag che indicano che si desidera distribuire questa classe come un EJB e che i metodi devono essere resi pubblici nell'interfaccia dell'EJB.
Utilizzando questa singola risorsa utente, WebSphere Rapid
Deployment può creare:
- le classi di interfaccia principale e remota
- una classe wrapper di implementazione della sessione stateless
- il descrittore di distribuzione EJB (ejb-jar.xml)
- i dati di binding specifici di WebSphere
- tutte le risorse utente restanti richieste per produrre un'applicazione J2EE conforme
Tutto ciò che bisogna utilizzare è una singola risorsa utente Java. Il codice per l'esempio EJB di sessione potrebbe essere simile al seguente:
/**
* @ejb.interface-method view-type=remote
*/
public String hello(String name)
{
return "Hello: " + name;
}
dove @ejb.interface-method view-type=remote è un esempio di un tag di annotazione.
Tag di annotazione
Le annotazioni sono commenti in stile Javadoc incorporati nel file sorgente Java. È possibile includere annotazioni nelle dichiarazioni di package, classe, campo o metodo.
Inoltre, la sintassi dei tag di XDoclet è supportata. Per ulteriori informazioni, vedere XDoclet.
I tag di annotazione vengono associati direttamente a risorse utente J2EE ed elementi del descrittore di distribuzione noti, che includono tag per i seguenti tipi di risorse utente e destinazioni di generazione:
- EJB
- Servlet
- Classi Java
- Servizi Web
Nota:
La documentazione XDoclet inclusa in questo prodotto IBM viene utilizzata con autorizzazione ed è coperta dalla seguente istruzione di attribuzione del copyright:
Copyright (c) 2000-2004, XDoclet Team. Tutti i diritti riservati.