001: /*
002: * JBoss, Home of Professional Open Source.
003: * Copyright 2006, Red Hat Middleware LLC, and individual contributors
004: * as indicated by the @author tags. See the copyright.txt file in the
005: * distribution for a full listing of individual contributors.
006: *
007: * This is free software; you can redistribute it and/or modify it
008: * under the terms of the GNU Lesser General Public License as
009: * published by the Free Software Foundation; either version 2.1 of
010: * the License, or (at your option) any later version.
011: *
012: * This software is distributed in the hope that it will be useful,
013: * but WITHOUT ANY WARRANTY; without even the implied warranty of
014: * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
015: * Lesser General Public License for more details.
016: *
017: * You should have received a copy of the GNU Lesser General Public
018: * License along with this software; if not, write to the Free
019: * Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
020: * 02110-1301 USA, or see the FSF site: http://www.fsf.org.
021: */
022: package org.jboss.mq.il.http;
023:
024: /**
025: * MBean interface.
026: * @created January 15, 2003
027: */
028: public interface HTTPServerILServiceMBean extends
029: org.jboss.mq.il.ServerILJMXServiceMBean {
030:
031: /**
032: * 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.
033: */
034: void setTimeOut(int timeout);
035:
036: /**
037: * Get the HTTPIL default timeout
038: */
039: int getTimeOut();
040:
041: /**
042: * 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.
043: */
044: void setRestInterval(int restInterval);
045:
046: /**
047: * Get the HTTPIL default RestInterval
048: */
049: int getRestInterval();
050:
051: /**
052: * 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).
053: */
054: void setURL(java.lang.String url);
055:
056: /**
057: * 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).
058: */
059: java.lang.String getURL();
060:
061: /**
062: * Set the HTTPIL URLPrefix. I.E. "http://" or "https://" The default is "http://"
063: */
064: void setURLPrefix(java.lang.String prefix);
065:
066: /**
067: * Get the HTTPIL URLPrefix. I.E. "http://" or "https://" The default is "http://"
068: */
069: java.lang.String getURLPrefix();
070:
071: /**
072: * Set the HTTPIL URLName.
073: */
074: void setURLHostName(java.lang.String hostname);
075:
076: /**
077: * Get the HTTPIL URLHostName.
078: */
079: java.lang.String getURLHostName();
080:
081: /**
082: * Set the HTTPIL URLPort. The default is 8080
083: */
084: void setURLPort(int port);
085:
086: /**
087: * Get the HTTPIL URLPort. The default is 8080
088: */
089: int getURLPort();
090:
091: /**
092: * Set the HTTPIL URLSuffix. I.E. The section of the URL after the port The default is "jbossmq-httpil/HTTPServerILServlet"
093: */
094: void setURLSuffix(java.lang.String suffix);
095:
096: /**
097: * Get the HTTPIL URLSuffix. I.E. The section of the URL after the port The default is "jbossmq-httpil/HTTPServerILServlet"
098: */
099: java.lang.String 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: }
|