Project Report: fawkez

Packagesummary org.jcoderz.commons.connector

org.jcoderz.commons.connector.ConnectionHandle

LineHitsNoteSource
1  /*
2   * $Id: ConnectionHandle.java 1011 2008-06-16 17:57:36Z amandel $
3   *
4   * Copyright 2006, The jCoderZ.org Project. All rights reserved.
5   *
6   * Redistribution and use in source and binary forms, with or without
7   * modification, are permitted provided that the following conditions are
8   * met:
9   *
10   *    * Redistributions of source code must retain the above copyright
11   *      notice, this list of conditions and the following disclaimer.
12   *    * Redistributions in binary form must reproduce the above
13   *      copyright notice, this list of conditions and the following
14   *      disclaimer in the documentation and/or other materials
15   *      provided with the distribution.
16   *    * Neither the name of the jCoderZ.org Project nor the names of
17   *      its contributors may be used to endorse or promote products
18   *      derived from this software without specific prior written
19   *      permission.
20   *
21   * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS "AS IS" AND
22   * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
23   * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
24   * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS AND CONTRIBUTORS
25   * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
26   * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
27   * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
28   * BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
29   * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
30   * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
31   * ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
32   */
33  package org.jcoderz.commons.connector;
34   
35  import javax.resource.ResourceException;
36   
37  /**
38   * The base connection handle interface.
39   *
40   */
41 (1)public interface ConnectionHandle
42  {
43     /**
44      * The underlying managed connection calls this method to force any cleanup
45      * on this connection handle. All futher calls on the public methods of this
46      * connection will throw a ResourceException.
47      *
48      * @throws ResourceException thrown in error cases.
49      */
50     void cleanUp ()
51           throws ResourceException;
52   
53     /**
54      * The underlying managed connection calls this method to force this handle
55      * change the managed connection's association. In other words, this handle
56      * should migrate to another managed connection.
57      *
58      * @param listener The new listener to be used for this handle.
59      *
60      * @throws ResourceException thrown in error cases.
61      */
62     void changeAssociation (ConnectionNotificationListener listener)
63           throws ResourceException;
64  }
65   

Findings in this File

c (2) Got an exception - java.lang.RuntimeException: Unable to get class information for @throws tag 'ResourceException'.
c (1) 41 : 0 Type Javadoc comment is missing an @author tag.