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  ;
25  import java.lang.annotation.Retention  ;
26  import java.lang.annotation.RetentionPolicy  ;
27  import java.lang.annotation.Target  ;
28  import java.util.concurrent.TimeUnit  ;
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  ({ElementType.METHOD})
40  @Retention  (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   unit() default TimeUnit.MILLISECONDS;
54  }
55
A to Z: JavaDoc & Examples Daily Java News & Articles Open Source Projects Open Source Codes Free Computer Books Remove Frame
Popular Tags