KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > org > jboss > aspects > concurrent > SemaphoreLocked


1 /*
2   * JBoss, Home of Professional Open Source
3   * Copyright 2005, JBoss Inc., and individual contributors as indicated
4   * by the @authors tag. See the copyright.txt in the distribution for a
5   * full listing of individual contributors.
6   *
7   * This is free software; you can redistribute it and/or modify it
8   * under the terms of the GNU Lesser General Public License as
9   * published by the Free Software Foundation; either version 2.1 of
10   * the License, or (at your option) any later version.
11   *
12   * This software is distributed in the hope that it will be useful,
13   * but WITHOUT ANY WARRANTY; without even the implied warranty of
14   * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15   * Lesser General Public License for more details.
16   *
17   * You should have received a copy of the GNU Lesser General Public
18   * License along with this software; if not, write to the Free
19   * Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
20   * 02110-1301 USA, or see the FSF site: http://www.fsf.org.
21   */

22 package org.jboss.aspects.concurrent;
23
24 import java.lang.annotation.ElementType JavaDoc;
25 import java.lang.annotation.Retention JavaDoc;
26 import java.lang.annotation.RetentionPolicy JavaDoc;
27 import java.lang.annotation.Target JavaDoc;
28 import java.util.concurrent.TimeUnit JavaDoc;
29
30
31 /**
32  * Only a certain amount of threads can access a @Semaphored object.
33  * Acquire a permit when entering a method, release it when leaving.
34  *
35  * @see Semaphored
36  *
37  * @author <a HREF="mailto:bill@jboss.org">Bill Burke</a>
38  */

39 @Target JavaDoc({ElementType.METHOD})
40 @Retention JavaDoc(RetentionPolicy.RUNTIME)
41 public @interface SemaphoreLocked
42 {
43    /**
44     * Num permits to acquire
45     */

46    int permits() default 1;
47    /**
48     * Defaults to -1, block until acquired
49     * 0 is just a tryLock
50     *
51     */

52    long timeout() default -1;
53    TimeUnit JavaDoc unit() default TimeUnit.MILLISECONDS;
54 }
55
Popular Tags