KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > org > jboss > axis > components > uuid > UUIDGenFactory


1 /*
2  * The Apache Software License, Version 1.1
3  *
4  *
5  * Copyright (c) 2001-2003 The Apache Software Foundation. All rights
6  * reserved.
7  *
8  * Redistribution and use in source and binary forms, with or without
9  * modification, are permitted provided that the following conditions
10  * are met:
11  *
12  * 1. Redistributions of source code must retain the above copyright
13  * notice, this list of conditions and the following disclaimer.
14  *
15  * 2. Redistributions in binary form must reproduce the above copyright
16  * notice, this list of conditions and the following disclaimer in
17  * the documentation and/or other materials provided with the
18  * distribution.
19  *
20  * 3. The end-user documentation included with the redistribution,
21  * if any, must include the following acknowledgment:
22  * "This product includes software developed by the
23  * Apache Software Foundation (http://www.apache.org/)."
24  * Alternately, this acknowledgment may appear in the software itself,
25  * if and wherever such third-party acknowledgments normally appear.
26  *
27  * 4. The names "Axis" and "Apache Software Foundation" must
28  * not be used to endorse or promote products derived from this
29  * software without prior written permission. For written
30  * permission, please contact apache@apache.org.
31  *
32  * 5. Products derived from this software may not be called "Apache",
33  * nor may "Apache" appear in their name, without prior written
34  * permission of the Apache Software Foundation.
35  *
36  * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
37  * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
38  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
39  * DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
40  * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
41  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
42  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
43  * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
44  * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
45  * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
46  * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
47  * SUCH DAMAGE.
48  * ====================================================================
49  *
50  * This software consists of voluntary contributions made by many
51  * individuals on behalf of the Apache Software Foundation. For more
52  * information on the Apache Software Foundation, please see
53  * <http://www.apache.org/>.
54  */
55
56 /**
57  *
58  * UUIDGen adopted from the juddi project
59  * (http://sourceforge.net/projects/juddi/)
60  *
61  */
62
63 package org.jboss.axis.components.uuid;
64
65 import org.jboss.axis.i18n.Messages;
66
67 /**
68  * A Universally Unique Identifier (UUID) is a 128 bit number generated
69  * according to an algorithm that is garanteed to be unique in time and space
70  * from all other UUIDs. It consists of an IEEE 802 Internet Address and
71  * various time stamps to ensure uniqueness. For a complete specification,
72  * see ftp://ietf.org/internet-drafts/draft-leach-uuids-guids-01.txt [leach].
73  *
74  * @author Steve Viens
75  * @version 1.0 11/7/2000
76  * @since JDK1.2.2
77  */
78 public abstract class UUIDGenFactory
79 {
80    private static final String JavaDoc defaultUUIDGenClassName = "org.jboss.axis.components.uuid.SimpleUUIDGen";
81
82    /**
83     * getInstance
84     * <p/>
85     * Returns the singleton instance of UUIDGen
86     */
87    public static UUIDGen getUUIDGen(String JavaDoc uuidgenClassName)
88    {
89       UUIDGen uuidgen = null;
90
91       if ((uuidgenClassName == null) || (uuidgenClassName.length() == 0))
92       {
93          // use the default UUIDGen implementation
94 uuidgenClassName = defaultUUIDGenClassName;
95       }
96
97       Class JavaDoc uuidgenClass = null;
98       try
99       {
100          // instruct the class loader to load the UUIDGen implementation
101 uuidgenClass = java.lang.Class.forName(uuidgenClassName);
102       }
103       catch (ClassNotFoundException JavaDoc e)
104       {
105          throw new RuntimeException JavaDoc(Messages.getMessage("uuidGenFactoryCNFE00", uuidgenClassName));
106       }
107
108       try
109       {
110          // try to instantiate the UUIDGen subclass
111 uuidgen = (UUIDGen)uuidgenClass.newInstance();
112       }
113       catch (java.lang.Exception JavaDoc e)
114       {
115          throw new RuntimeException JavaDoc(Messages.getMessage("uuidGenFactoryException02", uuidgenClass.getName(), e.getMessage()));
116       }
117
118       return uuidgen;
119    }
120
121    /**
122     * Release any aquired external resources and stop any background threads.
123     */
124    public static void destroyUUIDGen(UUIDGen uuidgen)
125    {
126       if (uuidgen != null)
127          uuidgen.destroy();
128    }
129 }
Popular Tags