KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > org > jboss > mq > il > http > HTTPServerILServiceMBean


1 /*
2 * JBoss, Home of Professional Open Source
3 * Copyright 2005, JBoss Inc., and individual contributors as indicated
4 * by the @authors tag. See the copyright.txt in the distribution for a
5 * full listing of individual contributors.
6 *
7 * This is free software; you can redistribute it and/or modify it
8 * under the terms of the GNU Lesser General Public License as
9 * published by the Free Software Foundation; either version 2.1 of
10 * the License, or (at your option) any later version.
11 *
12 * This software is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * Lesser General Public License for more details.
16 *
17 * You should have received a copy of the GNU Lesser General Public
18 * License along with this software; if not, write to the Free
19 * Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
20 * 02110-1301 USA, or see the FSF site: http://www.fsf.org.
21 */

22 package org.jboss.mq.il.http;
23
24 /**
25  * MBean interface.
26  * @created January 15, 2003
27  */

28 public interface HTTPServerILServiceMBean extends org.jboss.mq.il.ServerILJMXServiceMBean
29 {
30
31    /**
32     * Set the HTTPIL default timeout--the number of seconds that the ClientILService HTTP requests will wait for messages. This can be overridden on the client by setting the system property org.jboss.mq.il.http.timeout to an int value of the number of seconds. NOTE: This value should be in seconds, not millis.
33     */

34    void setTimeOut(int timeout);
35
36    /**
37     * Get the HTTPIL default timeout
38     */

39    int getTimeOut();
40
41    /**
42     * Set the HTTPIL default RestInterval--the number of seconds the ClientILService will sleep after each client request. The default is 0, but you can set this value in conjunction with the TimeOut value to implement a pure timed based polling mechanism. For example, you could simply do a short lived request by setting the TimeOut value to 0 and then setting the RestInterval to 60. This would cause the ClientILService to send a single non-blocking request to the server, return any messages if available, then sleep for 60 seconds, before issuing another request. Like the TimeOut value, this can be explicitly overriden on a given client by specifying the org.jboss.mq.il.http.restinterval with the number of seconds you wish to wait between requests.
43     */

44    void setRestInterval(int restInterval);
45
46    /**
47     * Get the HTTPIL default RestInterval
48     */

49    int getRestInterval();
50
51    /**
52     * Set the HTTPIL URL. This value takes precedence over any individual values set (i.e. the URLPrefix, URLSuffix, URLPort, etc.) It my be a actual URL or a propertyname which will be used on the client side to resolve the proper URL by calling System.getProperty(propertyname).
53     */

54    void setURL(java.lang.String JavaDoc url);
55
56    /**
57     * Get the HTTPIL URL. This value takes precedence over any individual values set (i.e. the URLPrefix, URLSuffix, URLPort, etc.) It my be a actual URL or a propertyname which will be used on the client side to resolve the proper URL by calling System.getProperty(propertyname).
58     */

59    java.lang.String JavaDoc getURL();
60
61    /**
62     * Set the HTTPIL URLPrefix. I.E. "http://" or "https://" The default is "http://"
63     */

64    void setURLPrefix(java.lang.String JavaDoc prefix);
65
66    /**
67     * Get the HTTPIL URLPrefix. I.E. "http://" or "https://" The default is "http://"
68     */

69    java.lang.String JavaDoc getURLPrefix();
70
71    /**
72     * Set the HTTPIL URLName.
73     */

74    void setURLHostName(java.lang.String JavaDoc hostname);
75
76    /**
77     * Get the HTTPIL URLHostName.
78     */

79    java.lang.String JavaDoc getURLHostName();
80
81    /**
82     * Set the HTTPIL URLPort. The default is 8080
83     */

84    void setURLPort(int port);
85
86    /**
87     * Get the HTTPIL URLPort. The default is 8080
88     */

89    int getURLPort();
90
91    /**
92     * Set the HTTPIL URLSuffix. I.E. The section of the URL after the port The default is "jbossmq-httpil/HTTPServerILServlet"
93     */

94    void setURLSuffix(java.lang.String JavaDoc suffix);
95
96    /**
97     * Get the HTTPIL URLSuffix. I.E. The section of the URL after the port The default is "jbossmq-httpil/HTTPServerILServlet"
98     */

99    java.lang.String JavaDoc getURLSuffix();
100
101    /**
102     * Set the HTTPIL UseHostName flag. if true the default URL will include a hostname, if false it will include an IP adddress. The default is false
103     */

104    void setUseHostName(boolean value);
105
106    /**
107     * Get the HTTPIL UseHostName flag. if true the default URL will include a hostname, if false it will include an IP adddress. The default is false
108     */

109    boolean getUseHostName();
110
111 }
112
Popular Tags