KickJava   Java API By Example, From Geeks To Geeks.

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


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

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

12 public interface LOVService
13    extends javax.ejb.EJBObject 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 )
26       throws javax.ejb.FinderException JavaDoc, java.rmi.RemoteException JavaDoc;
27
28    /**
29     * 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.
30     * @param p_lovOID The oid of the LOV that we want to parse.
31     * @param p_lovValueOID The oid that we want to find in the selected LOV.
32     * @return The LovValue having the oid p_lovValueOID in the LOV whose oid is p_lovOID.
33     * @throws NoSuchLovException if no LOV is found for the given p_lovOID.
34     * @throws NoSuchLovValueException if no LovValue is found having the p_lovValueOID in the selected LOV.
35     * @throws IllegalArgumentException if the given p_lovOID or p_lovValueOID is (are) null.
36     * @see LovValue
37     */

38    public org.bsf.listOfValues.lovValue.LovValue getLovValue( java.lang.Long JavaDoc p_lovOID,java.lang.Long JavaDoc p_lovValueOID )
39       throws org.bsf.listOfValues.exceptions.NoSuchLovException, org.bsf.listOfValues.exceptions.NoSuchLovValueException, java.rmi.RemoteException JavaDoc;
40
41    /**
42     * Returns, in the order of the executed SQL, the list of LovValues corresponding to the given p_lovOID.
43     * @param p_lovOID The oid of the LOV that we want to retrieve.
44     * @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).
45     * @throws IllegalArgumentException if the given lovOID is null.
46     * @throws NoSuchLovException if no LOV is having the given oid.
47     * @see LovBean
48     * @see LovValue
49     */

50    public java.util.List JavaDoc getListOfValues( java.lang.Long JavaDoc p_lovOID )
51       throws org.bsf.listOfValues.exceptions.NoSuchLovException, java.rmi.RemoteException JavaDoc;
52
53    /**
54     * Returns a map (LovValueOID, LovValue) of LovValues corresponding to the given p_lovOID.
55     * @param p_lovOID The oid of the LOV that we want to retrieve.
56     * @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).
57     * @throws IllegalArgumentException if the given p_lovOID is null.
58     * @throws NoSuchLovException if no LOV is having the given oid.
59     * @see LovBean
60     * @see LovValue
61     */

62    public java.util.Map JavaDoc getLovValues( java.lang.Long JavaDoc p_lovOID )
63       throws org.bsf.listOfValues.exceptions.NoSuchLovException, java.rmi.RemoteException JavaDoc;
64
65    /**
66     * 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.
67     * @param p_lovOID The oid of the LOV whose TABLE_NAME will be used to refresh the LOVs.
68     * @throws IllegalArgumentException if the given p_lovOID is null.
69     * @throws NoSuchLovException if there is no LOV having the given lovOID.
70     * @see LovBean
71     * @see #resynchronizeListOfValues(String p_tableName)
72     */

73    public void resynchronizeListOfValues( java.lang.Long JavaDoc p_lovOID )
74       throws org.bsf.listOfValues.exceptions.NoSuchLovException, java.rmi.RemoteException JavaDoc;
75
76    /**
77     * Ensures that the LOVs referencing the TABLE_NAME are reseted. Usually because the underlying data have changed.
78     * @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).
79     * @see LovBean
80     * @see #resynchronizeListOfValues(Long p_lovOID)
81     */

82    public void resynchronizeListOfValues( java.lang.String JavaDoc p_tableName )
83       throws java.rmi.RemoteException JavaDoc;
84
85 }
86
Popular Tags