KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > org > bsf > listOfValues > LOVServiceLocal


1 /*
2  * Generated by XDoclet - Do not edit!
3  */

4 package org.bsf.listOfValues;
5
6 /**
7  * Local interface for LOVService.
8  * @see LovBean
9  * @see LovValue
10  * @see LovBusinessInterface
11  */

12 public interface LOVServiceLocal
13    extends javax.ejb.EJBLocalObject JavaDoc
14 {
15    /**
16     * Provides access to the metadata for a given list of values.
17     * @param p_lovOID The OID of the list of values for which we want the metadata.
18     * @return A list of LovMetaDataItems for the LOV corresponding to the given lovOID.
19     * @throws IllegalArgumentException if the given oid is null.
20     * @throws FinderException if a lov with the given oid isn't found.
21     * @see LovBean
22     * @see LovValue
23     * @see LovMetaDataItem
24     */

25    public java.util.List JavaDoc getLOVMetaData( java.lang.Long JavaDoc p_lovOID ) throws javax.ejb.FinderException JavaDoc;
26
27    /**
28     * Returns the LovValue having the oid p_lovValueOID in the LOV whose oid is p_lovOID. If the LOV doesn't exist a NoSuchLovException is thrown whereas a NoSuchLovValueException is thrown if, while existing, the LOV does not contain the desired LovValue.
29     * @param p_lovOID The oid of the LOV that we want to parse.
30     * @param p_lovValueOID The oid that we want to find in the selected LOV.
31     * @return The LovValue having the oid p_lovValueOID in the LOV whose oid is p_lovOID.
32     * @throws NoSuchLovException if no LOV is found for the given p_lovOID.
33     * @throws NoSuchLovValueException if no LovValue is found having the p_lovValueOID in the selected LOV.
34     * @throws IllegalArgumentException if the given p_lovOID or p_lovValueOID is (are) null.
35     * @see LovValue
36     */

37    public org.bsf.listOfValues.lovValue.LovValue getLovValue( java.lang.Long JavaDoc p_lovOID,java.lang.Long JavaDoc p_lovValueOID ) throws org.bsf.listOfValues.exceptions.NoSuchLovException, org.bsf.listOfValues.exceptions.NoSuchLovValueException;
38
39    /**
40     * Returns, in the order of the executed SQL, the list of LovValues corresponding to the given p_lovOID.
41     * @param p_lovOID The oid of the LOV that we want to retrieve.
42     * @return A list of LovValues corresponding to the execution of the given lovOID. The LovValues are returned as they are retrieve from the execution of the SQL statement (cf. ORDER BY clause).
43     * @throws IllegalArgumentException if the given lovOID is null.
44     * @throws NoSuchLovException if no LOV is having the given oid.
45     * @see LovBean
46     * @see LovValue
47     */

48    public java.util.List JavaDoc getListOfValues( java.lang.Long JavaDoc p_lovOID ) throws org.bsf.listOfValues.exceptions.NoSuchLovException;
49
50    /**
51     * Returns a map (LovValueOID, LovValue) of LovValues corresponding to the given p_lovOID.
52     * @param p_lovOID The oid of the LOV that we want to retrieve.
53     * @return A list of LovValues corresponding to the execution of the given p_lovOID. The LovValues are returned as they are retrieve from the execution of the SQL statement (cf. ORDER BY clause).
54     * @throws IllegalArgumentException if the given p_lovOID is null.
55     * @throws NoSuchLovException if no LOV is having the given oid.
56     * @see LovBean
57     * @see LovValue
58     */

59    public java.util.Map JavaDoc getLovValues( java.lang.Long JavaDoc p_lovOID ) throws org.bsf.listOfValues.exceptions.NoSuchLovException;
60
61    /**
62     * Ensures that the LOVs using the same TABLE_NAME as the LOV identified by the given OID are reloaded (in general due to a data update). It includes, of course, the lov identified by the given lovOID.
63     * @param p_lovOID The oid of the LOV whose TABLE_NAME will be used to refresh the LOVs.
64     * @throws IllegalArgumentException if the given p_lovOID is null.
65     * @throws NoSuchLovException if there is no LOV having the given lovOID.
66     * @see LovBean
67     * @see #resynchronizeListOfValues(String p_tableName)
68     */

69    public void resynchronizeListOfValues( java.lang.Long JavaDoc p_lovOID ) throws org.bsf.listOfValues.exceptions.NoSuchLovException;
70
71    /**
72     * Ensures that the LOVs referencing the TABLE_NAME are reseted. Usually because the underlying data have changed.
73     * @param p_tableName The oid of the LOV whose TABLE_NAME will be used to refresh the LOVs. Does nothing if the name is invalid (null, no match).
74     * @see LovBean
75     * @see #resynchronizeListOfValues(Long p_lovOID)
76     */

77    public void resynchronizeListOfValues( java.lang.String JavaDoc p_tableName ) ;
78
79 }
80
Popular Tags