package org.jboss.examples;
public class foo
{
  @orange void somemethod();
  @orange private int somefield;
}

　　那么我们可以用annotation来干什么呢？一些人想用annotation来产生代码并替代xdoclet，其他人，象j2ee和ejb3.0专家组，将它视为部署描述符的替代。本文谈论在aop中如何使用annotation

　　aop概述

　　有许多的文章和书籍解释aop到底是什么，例如graham o'regan的onjava文章“introduction to aspect-oriented programming."我将在本文给出一个快速的概览，但我鼓励您在线做更多的研究。

　　假设您要添加代码到一个应用程序去测试调用一个特定的java方法所需的总的时间。该代码可能看起来如下：

    清单3：

public class bankaccount
{
public void withdraw(double amount)
{
long starttime = system.currenttimemillis();
try
{
// actual method body...
}
finally
{
long endtime = system.currenttimemillis() - starttime;
system.out.println("withdraw took: " + endtime);
}
}
}

　　虽然这些代码能够正常工作，但这个方法有一些问题：1.它难以打开和关闭测试，您必须在try/finally块中对每个方法或购置函数手工增加代码以进行基准测试。

　　2.这一轮廓代码并不真正属于贯穿整个应用的代码。它使得您的代码臃肿并难以理解，因为您必须将计时放在try/finally块中。

　　3、如果您想扩展它的功能以包含一个方法或是失败计数，或甚至是注册这些统计数据到一个更为复杂的报告机制中，您必须修改大量不同文件（又一次）。

　　metrics类提供了一个什么是横切（cross-cutting）关系的完美，简洁的小例子。jboss aop以一种含蓄的方式提供了一个简单的方法来封装和应用这样的关系，这样某些象度量操作代码不会弄乱您的编码。让我们稍为深入到jboss aop一些来看看如何实现。

　　为了使用jboss aop封装度量功能，您首先需要定义一个方面来指出该度量行为。

　　清单4：

public class metrics
{
public object profile(methodinvocation invocation) throws throwable
{
long starttime = system.currenttimemillis();
try
{
return invocation.invokenext();
}
finally
{
long endtime = system.currenttimemillis() - starttime;
java.lang.reflect.method m = invocation.getmethod();
system.out.println("method " + m.tostring() +
" time: " + endtime + "ms");
} }
}

　　一个方面只是一个具有定义了您想要附加到您的对象模型的行为的普通java类。这些方法的签名必须返回一个java.lang.object并且必须具有一个（并且只有一个）jboss aop 调用对象参数，它被用来封装方法，构造函数或字段调用。方法名可以是任何你想要的并且当您绑定该方面到您的代码片断时被引用。

　　下面要做的事情就是实际应用方面到您想要它勾勒一个方法的执行的某个程序点。大多数aop框架提供了一个指向表达式语言，在此处您可以定义您想要某个方面行为被附加到的位置。下面是在jboss aop中的做法。

　　清单5：jboss-aop.xml

<aop>
<aspect class="metrics"/>
 
<bind pointcut="execution(public void bankaccount->withdraw(double amount))">
<advice name="profile" aspect="metrics"/>
</bind>
</aop>

　　采用在metrics.java中对方面的定义和jboss-aop.xml中的指向定义，该度量代码现在以含蓄而又透明地应用到bankaccount.withdraw（）方法中并能在勾勒代码不再需要时轻易地移除。

　　对于jboss aop更多的信息，请查询分发包中的指南。其中具有大约20个例子来带领您漫游如何使用jboss aop框架。

　　嘘！现在我们已经进行了一个概览，让我们深入到本文的中心内容。我将再次给您提供一些例子，因为这是我所知道的讲授一个新的概念的最好的方法。

　　正如我前面说的，annotation加上aop几乎是给予您扩展java语言的能力。annotation提供了声明新的，可兼容的，类型安全的语法机制。aop提供了封装和应用新的行为到一个语法表达式的机制。

　　方法annotation和aop

　　让我们看看如何使用方法annotation和aop.使用annotation和aop并应用到一个方法类似于使用java的synchronized关键字。当您设定一个方法为synchronized，您在告诉jvm：您想该方法在被调用时以一种特殊的方式进行。annotation允许您定义一个新的关键字来触发您自己的特殊的定制行为。aop给予您封装这一行为的能力并将其“编织”进该方法的执行中。再次的，这一概念的最佳描述是通过一个例子。

　　让我们假设我们想要添加新的语法，使用该语法使得我们可以在方法被标签为@oneway时，在后台以另一个线程调用这个void方法。可以象这样使用新的语法：

　　清单6：

　　最后，我们必须定义xml绑定来触发当@inject标签应用到一个字段时injecttmaspect的应用。指向表达式基本上说明了对任意一个标记为@inject的transactionmanager字段应用injecttmaspect.

清单16：

<aop>
<aspect class="org.jboss.aspects.injecttmaspect"/>
<bind pointcut="field(javax.transaction.transactionmanager *->@org.jboss.aspects.inject)">
<advice name="access"
aspect="org.jboss.aspects.injecttmaspect"/>
</bind>
</aop>

　　现在annotation、方面类和xml绑定已经定义，我们可以在我们的代码中使用了。

　　清单17：

import javax.transaction.transactionmanager;
import org.jboss.aspects.inject;
public class mytransactionalcache
{
@inject private transactionmanager tm;
...
}

　　更多预打包例子

　　jboss aop不仅仅是关于aop框架。它还有一个丰富的方面库，您可以直接在您的应用中使用。在这个库中是一个比我们现在在本文展示的例子更为复杂的annotation方面集。这些方面包括异步调用，事务划分，事务锁定和基于角色的安全。让我们简要地浏览一下以提供给您一个更好的关于annotation和aop共同工作的考虑。

　　异步方面

　　jboss aop异步方面允许您定义任何方法为异步的，这样它可以在后台被执行。这对于我们的@oneway例子来说有些困难，因为它使用oswego并行包中的执行器工具，并为那些具有一个返回类型的方法提供了一个方法来异步地接收回响应。要使用这个方面，您只需标记一个方法为@asybchronous.

清单18：

public foo {
@asynchronous public int somemethod(int somearg) {...}
}　　

@asynchronous标签的应用做了一些事情。与在本文中的@oneway例子一样，它应用一个在后台运行该方法的方面。而且，采用@asynchronous标签，您并不仅限于void方法并可于实际上返回一个值的方法进行交互。当@asynchronous标签被应用，它强制foo类实现asynchronousfacade接口。在aop领域，这称为接口引入（interface introduction）。asynchronousfacade接口允许您预测一个响应或以超时限定等待一个响应。最好用一个例子来解释。

　　清单19：

foo foo = new foo();
somemethod(555); // executes in background
asynchronousfacade facade = (asynchronousfacade)foo;
asynchronousresponse response = facde.waitforresponse();
system.out.println(response.getreturnvalue());

　　您可以启动多个不同对象的多个不同方法的多个调用，并异步积累它们的响应。

　　事务锁定

　　有时在j2ee事务期间而不是一个方法执行，构造函数调用或同步块执行期间同步一个对象或类会很有用。对这类事务同步或锁定，jboss aop发明了@txsynchronized关键字。您可以使用@txsynchronized在任意成员或静态方法已经构造函数上。

　　清单20：

import org.jboss.aspects.txlock.txsynchronized;
public foobar
{
@txsynchronized public foobar() {}
@txsynchronized static void staticmethod() {}
@txsynchronized public membermethod() {}
}

　　如果一个被标记为@txsynchronized的构造函数或静态方法被调用，类的锁监视器会在事务执行期间被保持着。如果一个标记为@txsynchronized的成员方法被调用，该对象实例的锁监视器将被保持直到目前的事务提交或回退。控制该行为的方面也将做死锁检测并在发生死锁时抛出runtimeexception.

　　j2ee 散餐（原文法文：a la carte）之：事务划分

　　ejb3.0已经定义了一些annotation进行事务划分。jboss aop在此基础上构建。这样您可以通过指定annotation应用事务划分到任意方法（静态或成员）以及任何java类构造函数。

清单21：

import org.jboss.aspects.tx.*;
public class foo
{
@tx(txtype.required) public foo {}
@tx(txtype.requiresnew) public static createfoo() {
return new foo();
}
}

　　j2ee 散餐之：基于角色的安全

　　ejb 3.0也定义了一些annotation实现基于角色的安全。jbos aop是基于此构建的，所以您可以应用基于角色的安全到任何的字段或方法（静态或成员）已经构造函数。

　　清单22：

import org.jboss.aspects.security.*;
@securitydomain("ldap repository")
public class foo
{
@permissions({"admin"}) public foo() {}
@permissions({"developer"}) public static int status;
@permissions({"anybody"}) public static void dosomething() {...}
}

　　ejb演变

　　随着aop与ejb规范一起渐渐成熟，我真正希望发生的是ejb规范定义的annotation将能在任何上下文作为新的java语言的形容词被使用，而不是让它们有限的使用在会话bean中。想象一下，一个真正的无状态bean仅仅成为一个明文java类的一个静态方法集。

　　清单23：

public mysessionbean
{
@tx(txtype.required) public static dosomething() {...}
}

　　无论如何，这些关于aop和ejb的讨论很可能就是为了ejb4.0.

　　结论

　　并非是限制j2se5.0annotation用于代码生成，annotation和aop可以被结合起来提供新的能力给框架开发者。这一结合允许开发者定义新的具有行为附加到其上的java语法。基本上，以安全的方式扩展java语言的能力已尽在掌握。