ViewVC Help
View File | Revision Log | Show Annotations | Revision Graph | Root Listing
root/i-scream/projects/cms/source/server/uk/org/iscream/cms/server/clientinterface/CorbaClientListenerServant.java
Revision: 1.13
Committed: Mon May 5 22:05:06 2003 UTC (21 years ago) by tdb
Branch: MAIN
Changes since 1.12: +2 -3 lines
Log Message: 
Tidy up of the client interface code - more commonly known as the
"right hand side of the server". Right since the start the filter
side of the server has been nice and tree like - every Filter sent
data to another Filter. At the top of the tree there was a "special"
Filter known as the RootFilter, which to the other Filters just
looked like a normal Filter. This was nice, and simple, and expandable.

The Client Interface on the other hand was messy. The root filter
had some hacky wrapper threads which pulled from a queue and pushed
to the relevant client interfaces (one for real time stuff, and the
other for databases). There was no simple room for expandability -
it was all hardwired to do just what was needed at the time.

This commit changes that. A Client Interface now connects to another
Client Interface, with a special one being found in the RootFilter
(yes, maybe that needs a name change now :-). So we can chain client
interfaces, and move other bits and bobs around in the server - for
example, alerting no longer needs to be connected to the Client
Interface, it can connect straight to the RootFilter (or, wherever
the config tells it ;).

Hopefully this sanitizes the underlying layout of the server a bit.

As a final note, I dropped the DBInterface. This used to insert
data in to a MySQL database. We've long since stopped using that,
and it's fallen behind and is way out of date. For now, it's gone
in to the attic.

File Contents

# Content
1 /*
2 * i-scream central monitoring system
3 * http://www.i-scream.org.uk
4 * Copyright (C) 2000-2002 i-scream
5 *
6 * This program is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU General Public License
8 * as published by the Free Software Foundation; either version 2
9 * of the License, or (at your option) any later version.
10 *
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details.
15 *
16 * You should have received a copy of the GNU General Public License
17 * along with this program; if not, write to the Free Software
18 * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
19 */
20
21 //---PACKAGE DECLARATION---
22 package uk.org.iscream.cms.server.clientinterface;
23
24 //---IMPORTS---
25 import uk.org.iscream.cms.server.core.*;
26 import uk.org.iscream.cms.util.*;
27 import uk.org.iscream.cms.server.componentmanager.*;
28
29 /**
30 * This class, a servant, listens for incoming connections from CORBA based
31 * clients. Once it receives a connection it creates and assigns a CorbaControlHandler
32 * object to it. The CorbaControlHandler will then handle all requests on behalf of the
33 * client, and will send the client data.
34 *
35 * @author $Author: tdb $
36 * @version $Id: CorbaClientListenerServant.java,v 1.12 2003/02/05 16:43:46 tdb Exp $
37 */
38 class CorbaClientListenerServant extends CorbaClientListenerPOA {
39
40 //---FINAL ATTRIBUTES---
41
42 /**
43 * The current CVS revision of this class
44 */
45 public final String REVISION = "$Revision: 1.12 $";
46
47 //---STATIC METHODS---
48
49 //---CONSTRUCTORS---
50
51 /**
52 * Creates a new CorbaClientListenerServant.
53 *
54 * @param packetSorter a reference to the PacketSorter object being used
55 */
56 public CorbaClientListenerServant(PacketSorter packetSorter) {
57 _packetSorter = packetSorter;
58 _logger.write(toString(), Logger.SYSINIT, "created");
59 }
60
61 //---PUBLIC METHODS---
62
63 /**
64 * Allows a CORBA client to connect to the server.
65 *
66 * @param client a reference to the "servant" part of the connecting client.
67 * @param name a name to identify the client.
68 * @return a CorbaControlHandler reference.
69 */
70 public CorbaControlHandler connect(Client client, String name) {
71 CorbaControlHandlerServant cchServant = new CorbaControlHandlerServant(_packetSorter, client, name);
72 org.omg.CORBA.Object objRef;
73 try {
74 objRef = _refman.getRootPOA().servant_to_reference(cchServant);
75 } catch (Exception e) {
76 objRef = null;
77 _logger.write(toString(), Logger.ERROR, "Error creating CorbaControlHandler: "+e);
78 }
79 CorbaControlHandler corbaHandler = CorbaControlHandlerHelper.narrow(objRef);
80 return corbaHandler;
81 }
82
83 /**
84 * Overrides the {@link java.lang.Object#toString() Object.toString()}
85 * method to provide clean logging (every class should have this).
86 *
87 * This uses the uk.org.iscream.cms.util.NameFormat class
88 * to format the toString()
89 *
90 * @return the name of this class and its CVS revision
91 */
92 public String toString() {
93 return FormatName.getName(
94 _name,
95 getClass().getName(),
96 REVISION);
97 }
98
99 //---PRIVATE METHODS---
100
101 //---ACCESSOR/MUTATOR METHODS---
102
103 //---ATTRIBUTES---
104
105 /**
106 * This is the friendly identifier of the
107 * component this class is running in.
108 * eg, a Filter may be called "filter1",
109 * If this class does not have an owning
110 * component, a name from the configuration
111 * can be placed here. This name could also
112 * be changed to null for utility classes.
113 */
114 private String _name = ClientInterfaceMain.NAME;
115
116 /**
117 * This holds a reference to the
118 * system logger that is being used.
119 */
120 private Logger _logger = ReferenceManager.getInstance().getLogger();
121
122 /**
123 * A reference to the reference manager in use
124 */
125 private ReferenceManager _refman = ReferenceManager.getInstance();
126
127 /**
128 * A reference to the PacketSorter.
129 */
130 private PacketSorter _packetSorter;
131
132 //---STATIC ATTRIBUTES---
133
134 }