KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > org > apache > soap > server > DefaultConfigManager


1 /*
2  * The Apache Software License, Version 1.1
3  *
4  *
5  * Copyright (c) 2000 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 "SOAP" 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 and was
52  * originally based on software copyright (c) 2000, International
53  * Business Machines, Inc., http://www.apache.org. For more
54  * information on the Apache Software Foundation, please see
55  * <http://www.apache.org/>.
56  */

57
58 package org.apache.soap.server ;
59
60 import java.util.* ;
61 import java.io.* ;
62 import javax.servlet.* ;
63 import javax.servlet.http.* ;
64 import org.apache.soap.* ;
65 import org.apache.soap.rpc.* ;
66 import org.apache.soap.server.* ;
67 import org.apache.soap.server.http.* ;
68 import org.apache.soap.util.* ;
69
70 /**
71  * A <code>DefaultConfigManager</code> ...
72  *
73  * @author Dug (dug@us.ibm.com)
74  * @author <a HREF="mailto:magnus@handpoint.com">Magnus Thor Torfason</a>
75  *
76  * With the introduction of a ConfigManager, the notion of a SOAP
77  * configuration file was also introduced. The SOAP server will now
78  * look for a 'soap.xml' file - or whatever filename was specified
79  * by the 'ConfigFile' init parameter of the Servlet.
80  * The soap.xml file should look like:
81  * <soapServer>
82  * <!-- This section defines the same thing you get if you don't -->
83  * <!-- specify anything at all - aka the default -->
84  * <configManager value="org.apache.soap.server.DefaultConfigManager" >
85  * <option name="filename" value="DS.ds" />
86  * </configManager>
87  * </soapServer>
88  *
89  * If not specified, the DefaultConfigManager will be used. By
90  * default this will write the list of deployed services out to a file
91  * called 'DeployedServices.ds' in the current directory. To change
92  * this simply use the 'filename' option in the 'configManager' section
93  * of the soap.xml configuration file.
94  *
95  */

96 public class DefaultConfigManager extends BaseConfigManager
97           implements ConfigManager {
98
99   /** The name of the deployment file. */
100   protected String JavaDoc filename = "DeployedServices.ds";
101
102
103   /**
104    * This method sets the configuration options (usually
105    * read from the config file).
106    */

107   public void setOptions( Hashtable options ) {
108     if ( options == null ) return ;
109
110     String JavaDoc value = (String JavaDoc) options.get( "filename" );
111     if ( value != null && !"".equals(value) )
112       filename = value ;
113   }
114
115   /**
116    * Loads the descriptors from the underlying registry file, which
117    * contains a serialized Hashtable.
118    */

119   public void loadRegistry() throws SOAPException {
120     // load in a serialized thing
121
dds = null ;
122     try {
123       File file = ServerHTTPUtils.getFileFromNameAndContext(filename,
124                                                             context);
125       FileInputStream fis = new FileInputStream (file);
126       ObjectInputStream is = new ObjectInputStream (fis);
127
128       dds = (Hashtable) is.readObject ();
129       is.close ();
130     } catch(Exception JavaDoc e) {
131       dds = new Hashtable ();
132       System.err.println ("SOAP Service Manager: Unable to read '" +
133                           filename + "': assuming fresh start");
134     }
135   }
136
137   /**
138    * Saves currently deployed descriptors to the underlying registry file,
139    * as a serialized Hashtable.
140    */

141   public void saveRegistry() throws SOAPException {
142     try {
143       File file = ServerHTTPUtils.getFileFromNameAndContext(filename,
144                                                             context);
145       FileOutputStream fos = new FileOutputStream (file);
146       ObjectOutputStream os = new ObjectOutputStream (fos);
147
148       os.writeObject (dds);
149       os.close ();
150     } catch (Exception JavaDoc e) {
151       throw new SOAPException (Constants.FAULT_CODE_SERVER,
152                                "Error saving services registry: " +
153                                e.getMessage ());
154     };
155   }
156 };
157
Popular Tags