// Copyright (C) 2000 by Matt Towers <eBozo_AT_hotmail_DOT_com>.
// All rights reserved. Use of this class is limited.
// Please see the LICENSE for more information.
/*
The source code and object code, of the HttpsMessage class is copyright and
owned by Matt Towers.
Feel free to use the HttpsMessage class in the development of any development
project. For this use you are granted a non-exclusive, non-transferable
limited license at no cost.
Redistribution of the HttpsMessage source code is permitted provided that the
following conditions are met:
1.You maintain the original copyright notice in the source code.
2.This license file is redistributed with the source code.
3.You acknowledge that the parent HttpMessage class, with which this class
is intended to be used, is owned and copyrighted by Jason Hunter
<jhunter_AT_acm_DOT_org>. (For more information see
http://www.servlets.com)
To clarify, you may use the HttpsMessage class to build new software and may
distribute the object code as you see fit. You may NOT distribute the source
code as part of a software development kit, other library, or development tool
without consent of the copyright holder. Any modified form of the HttpsMessage
class is bound by these same restrictions.
Note that the HttpsMessage class is provided "as is" and the author will not
be liable for any damages suffered as a result of your use.
Furthermore, you understand the source code comes without any technical
support.
THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS
OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
SUCH DAMAGE.
Matt Towers <eBozo_AT_hotmail_DOT_com>
*/
package com.oreilly.servlet;
import java.net.*;
import java.security.Security;
import java.security.Provider;
/**
* A class to simplify HTTP/HTTPS client-server communication. It abstracts
* the communication into messages, which can be either GET or POST.
* <p>
* It can be used like this:
* <blockquote><pre>
*
* HttpsMessage msg = new HttpsMessage("https://[some server]");
*
* Properties props = new Properties();
* props.put("name", "value");
*
* InputStream in = msg.sendGetMessage(props);
* </pre></blockquote>
* This class extends the HttpMessage class
* written by Jason Hunter at servlets.com.
* The HttpMessage class can be found in the com.oreilly.servlet
* package found at www.servlets.com
* <p>
* For information see http://www.javaworld.com/javatips/jw-javatip96.html
* Note this class works with JDK 1.2 or later only.
* <p>
* @author <b>Matt Towers</b>
* @author Copyright © 2000
* @version 1.0, 2000/05/05
*/
public class HttpsMessage extends com.oreilly.servlet.HttpMessage
{
//A flag to indicate weather or not the stream handler has been set
static boolean m_bStreamHandlerSet = false;
/**
* Constructs a new HttpsMessage that can be used to communicate with the
* servlet at the specified URL using HTTPS.
*
* @param szURL the server resource (typically a servlet) with which
* to communicate
*/
public HttpsMessage(String szURL) throws Exception
{
super(null);
//If the stream handler has already been set
//there is no need to do anything
if( !m_bStreamHandlerSet )
{
String szVendor = System.getProperty("java.vendor");
String szVersion = System.getProperty("java.version");
//Assumes a system version string of the form [major].[minor].[release] (eg. 1.2.2)
Double dVersion = new Double(szVersion.substring(0, 3));
//Otherwise, if we are running in a MS environment, use the MS stream handler.
if( -1 < szVendor.indexOf("Microsoft") )
{
try
{
Class clsFactory = Class.forName("com.ms.net.wininet.WininetStreamHandlerFactory" );
if ( null != clsFactory)
URL.setURLStreamHandlerFactory((URLStreamHandlerFactory)clsFactory.newInstance());
}
catch( ClassNotFoundException cfe )
{
throw new Exception("Unable to load the Microsoft SSL stream handler. Check classpath." + cfe.toString());
}
//If the stream handler factory has already been successfuly set
//make sure our flag is set and eat the error
catch( Error err ){m_bStreamHandlerSet = true;}
}
//If we are in a normal Java environment, try to use the JSSE handler.
else if( 1.2 <= dVersion.doubleValue() )
{
System.getProperties().put("java.protocol.handler.pkgs", "com.sun.net.ssl.internal.www.protocol");
try
{
//if we have the JSSE provider available, and it has not already been
//set, add it as a new provide to the Security class.
Class clsFactory = Class.forName("com.sun.net.ssl.internal.ssl.Provider");
if( (null != clsFactory) && (null == Security.getProvider("SunJSSE")) )
Security.addProvider((Provider)clsFactory.newInstance());
}
catch( ClassNotFoundException cfe )
{
throw new Exception("Unable to load the JSSE SSL stream handler. Check classpath." + cfe.toString());
}
}
m_bStreamHandlerSet = true;
}
super.servlet = new URL(szURL);
}
}