KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > org > tigris > scarab > om > UserPreferenceManager


1 package org.tigris.scarab.om;
2
3 /* ================================================================
4  * Copyright (c) 2000-2003 CollabNet. 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  * 1. Redistributions of source code must retain the above copyright
11  * notice, this list of conditions and the following disclaimer.
12  *
13  * 2. Redistributions in binary form must reproduce the above copyright
14  * notice, this list of conditions and the following disclaimer in the
15  * documentation and/or other materials provided with the distribution.
16  *
17  * 3. The end-user documentation included with the redistribution, if
18  * any, must include the following acknowlegement: "This product includes
19  * software developed by CollabNet <http://www.Collab.Net/>."
20  * Alternately, this acknowlegement may appear in the software itself, if
21  * and wherever such third-party acknowlegements normally appear.
22  *
23  * 4. The hosted project names must not be used to endorse or promote
24  * products derived from this software without prior written
25  * permission. For written permission, please contact info@collab.net.
26  *
27  * 5. Products derived from this software may not use the "Tigris" or
28  * "Scarab" names nor may "Tigris" or "Scarab" appear in their names without
29  * prior written permission of CollabNet.
30  *
31  * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
32  * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
33  * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
34  * IN NO EVENT SHALL COLLAB.NET OR ITS CONTRIBUTORS BE LIABLE FOR ANY
35  * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
36  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
37  * GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
38  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
39  * IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
40  * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
41  * ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
42  *
43  * ====================================================================
44  *
45  * This software consists of voluntary contributions made by many
46  * individuals on behalf of CollabNet.
47  */
48
49 import org.apache.torque.TorqueException;
50
51 /**
52  * This is the manager for the UserPreferences
53  *
54  * @author <a HREF="mailto:jmcnally@collab.net">John McNally</a>
55  * @version $Id: UserPreferenceManager.java 9104 2004-05-10 21:04:51Z dabbous $
56  */
57 public class UserPreferenceManager
58     extends BaseUserPreferenceManager
59 {
60     /**
61      * Creates a new <code>UserPreferenceManager</code> instance.
62      *
63      * @exception TorqueException if an error occurs
64      */
65     public UserPreferenceManager()
66         throws TorqueException
67     {
68         super();
69         setRegion(getClassName().replace('.', '_'));
70     }
71
72     /**
73      * @throws IllegalArgumentException If <code>userid</code> is
74      * <code>null</code>.
75      */
76     public static UserPreference getInstance(Integer JavaDoc userid)
77         throws TorqueException
78     {
79         if (userid == null)
80         {
81             throw new IllegalArgumentException JavaDoc("User ID cannot be null"); //EXCEPTION
82 }
83
84         UserPreference up = null;
85         try
86         {
87             up = BaseUserPreferenceManager.getInstance(userid);
88         }
89         catch (TorqueException te)
90         {
91             // Empty result...Failed to select one and only one row.
92 }
93         if (up == null)
94         {
95             up = UserPreferenceManager.getInstance();
96             up.setUserId(userid);
97         }
98         return up;
99     }
100 }
101
Popular Tags