Managed File Transfer and Security Solutions

Creating TCP/IP client socket connections in Java

Overview 

     The article will demonstrate how to use the ipclient component in Secure iNet Factory to create TCP/IP client socket connections.

Code Example

Download IpClientEx.java

 

           

01 import java.io.*; 02 import com.jscape.inet.ipclient.*; 03 04 public class IpClientEx implements IpClientListener 05 { 06  public void connected(IpClientConnectedEvent event) 07  { 08  System.out.println("Connected to host: " + event.getHostname()); 09  } 10 11  public void disconnected(IpClientDisconnectedEvent event) 12  { 13  System.out.println("Disconnected from host: " + event.getHostname()); 14  } 15   16  public static void main(String[] args) 17  { 18  try 19  { 20  // create new IpClient instance 21  IpClient client = new IpClient("www.yahoo.com",80); 22  // subscribe listener 23  client.addIpClientListener(new IpClientEx()); 24  // establish connection 25  client.connect(); 26  // get output stream 27  OutputStream out = client.getOutputStream(); 28  // send data 29  String command = "GET / HTTP/1.0\r\n\r\n"; 30  out.write(command.getBytes()); 31  out.flush(); 32  // get input stream 33  InputStream in = client.getInputStream(); 34  // read data from server 35  int i = 0; 36  while((i = in.read()) != -1) System.out.print((char)i);  37  // disconnect 38  client.disconnect(); 39  } 40  catch (Exception e) 41  { 42  e.printStackTrace(); 43  } 44 45  } 46 } Lines 1-2  : Necessary import statements. Lines 6-14 : Events from the attached IpClientListener. Line 21    : Create new IpClient instance. Line 23    : Add IpClientListener so this instance of IpClient can receive events. Lines 25-31 : Open the connection, issue a HTTP GET command and read the response. Lines 35-36 : Print the response to the console. Lines 38 : Disconnect from the remote server. For a complete list of HTTP commands go here.

Communicating with IMAP servers using SSL/TLS in Java

Overview 

     The article will demonstrate how to use the imap component in Secure iNet Factory to communicate with imap servers in java using ssl/tls.

Code Example

Download IMAPSSLEx.java

               

01 import java.util.Enumeration; 02 import com.jscape.inet.email.EmailMessage; 03 import com.jscape.inet.imapssl.ImapSsl; 04 05 public class IMAPSSLEx 06 { 07  public static void main(String[] args) 08  { 09  try 10  { 11  // replace these values with your own credentials 12  String hostname = "hostname"; 13  String username = "username"; 14  String password = "password"; 15  ImapSsl ssl = new ImapSsl(hostname,993,username,password); 16   17  // establish implicit SSL connection on port 993 18  ssl.connect(); 19   20  // get messages and print out subject 21  Enumeration e = ssl.getMessages(); 22  while(e.hasMoreElements()) 23  { 24  EmailMessage msg = (EmailMessage)e.nextElement(); 25  System.out.println("Subject: " + msg.getSubject());                                26  } 27   28  // disconnect 29  ssl.disconnect(); 30  } 31  catch (Exception e) 32  { 33  e.printStackTrace(); 34  } 35  } 36 } Lines 1-3   : Necessary import statements. Line  15    : Create new ImapSsl instance. Lines 21-26 : Get messages and print them to the console. Line 29     : Disconnect from the server.      The ImapSsl class provides both implicit and explicit SSL/TLS connections.  Implicit SSL/TLS connections are made by default using remote port 993.  Explicit SSL/TLS connections are made using an unencrypted connection to port 143 of an IMAP server and then switching to an encrypted mode using the STARTTLS command prior to sending any additional data.

               

01 import java.util.Enumeration; 02 import com.jscape.inet.email.EmailMessage; 03 import com.jscape.inet.imapssl.ImapSsl; 04 05 public class IMAPSSLEx 06 { 07  public static void main(String[] args) 08  { 09  try 10  { 11  // replace these values with your own credentials 12  String hostname = "hostname"; 13  String username = "username"; 14  String password = "password"; 15   16  // create new ImapSsl instance 17  ImapSsl ssl = new ImapSsl(hostname,143,username,password); 18  // set connection type 19  ssl.setConnectionType(ImapSsl.STARTTLS); 20  // establish explicit SSL connection on port 143 using STARTTLS command 21  ssl.connect(); 22  // get messages and print out subject 23  Enumeration e = ssl.getMessages(); 24  while(e.hasMoreElements()) 25  { 26  EmailMessage msg = (EmailMessage)e.nextElement(); 27  System.out.println("Subject: " + msg.getSubject());                                28  } 29 30  // disconnect 31  ssl.disconnect(); 32  } 33  catch (Exception e) 34  { 35  e.printStackTrace(); 36  } 37  } 38 } Lines 1-3 : Neccesary imports. Line  17  : Create ImapSsl instance. Line  19   : Set the connection type (use STARTTLS command). Lines 23-28 : Get messages and print them out to the console.

Uploading files using SFTP in Java

Overview 

     The article will demonstrate how to use the sftp component in Secure FTP Factory to upload files and directories. This component can be used to transfer files between a client and SSH (Secure Shell).

Code Example

Download SFTPExample.java

               

001 // required import statements 002 import java.io.*; 003 import java.util.*; 004 005 import com.jscape.inet.sftp.Sftp; 006 import com.jscape.inet.sftp.SftpException; 007 import com.jscape.inet.sftp.SftpFile; 008 import com.jscape.inet.sftp.events.SftpAdapter; 009 import com.jscape.inet.sftp.events.SftpConnectedEvent; 010 import com.jscape.inet.sftp.events.SftpDisconnectedEvent; 011 import com.jscape.inet.ssh.util.SshParameters; 012 013 public class SFTPExample extends SftpAdapter 014 { 015  private String hostname; 016  private String username; 017  private String password; 018  private Sftp sftp; 019   020  public SFTPExample(String hostname, String username, String password) 021  { 022  // initialize local SFTP instance with hostname, username and password. 023  sftp = new Sftp(new SshParameters(hostname, 024  username, 025  password)); 026   027  // register the listener so this instance can recieve events. 028  sftp.addSftpListener(this); 029  } 030   031  // open connection to the remote server. 032  public void openConnection() throws SftpException 033  { 034  sftp.connect(); 035  } 036   037  // disconnect from the remote server. 038  public void closeConnection() 039  { 040  sftp.disconnect(); 041  } 042   043  // set binary transfer mode 044  public void setBinaryMode() 045  { 046  this.setAutoDetectFileMode(false); 047  sftp.setBinary(); 048  } 049   050  // set ASCII transfer mode 051  public void setAsciiMode() 052  { 053  this.setAutoDetectFileMode(false); 054  sftp.setAscii(); 055  } 056   057  // automatically detect the transfer mode 058  public void setAutoDetectFileMode(boolean value) 059  { 060  sftp.setAuto(value);  061  } 062   063  // provide a filename expression to upload 064  // e.g. : 065  // *.*       upload all files from in the current local directory. 066  // .*\\.gif  upload all files with the GIF image extension. 067  public void uploadFile(String expression) throws SftpException 068  { 069  sftp.mupload(expression); 070  } 071   072  // call this method if you want to append data to an existing file 073  // e.g. 074  // File src = new File("c:/tmp/logs.txt"); 075  // String dest = "all-logs.txt"; 076  // sftp.upload(src,dest,true); 077  public void uploadFile(String source, String dest, boolean append) throws SftpException 078  { 079  sftp.upload(new File(source), dest, true); 080  } 081   082  // upload a directory 083  // e.g. : 084  // uploadDir(new File("e:/somedir")); 085  // This call will upload "somedir" to the remote server 086  public void uploadDir(File file) throws SftpException 087  { 088  sftp.uploadDir(file); 089  } 090   091  // upload from memory 092  // e.g. 093  // String someData = "data"; 094  // upload(someData.getBytes(), "data.txt"); 095  public void upload(byte[] b, String file) throws SftpException 096  { 097  sftp.upload(b, file); 098  } 099   100  // set local directory to upload from 101  public void setLocalDir(String dir) 102  { 103  sftp.setLocalDir(new File(dir)); 104  } 105   106  // set remote directory to upload to 107  public void setRemoteDir(String dir) throws SftpException 108  { 109  sftp.setDir(dir); 110  } 111   112  // this method is invoked when when client connects to the remote server. 113  public void connected(SftpConnectedEvent evt) 114  { 115  System.out.println("Connected to host: " + evt.getHostname()); 116  } 117 118  // this method is invoked when client disconnects from the remote server. 119  public void disconnected(SftpDisconnectedEvent evt) 120  { 121  System.out.println("Disconnected from host: " + evt.getHostname()); 122  } 123   124  public static void main(String[] args) 125  { 126  String hostname = null; 127  String username = null; 128  String password = null; 129  try 130  { 131  BufferedReader reader = new BufferedReader(new InputStreamReader(System.in)); 132  System.out.print("Enter hostname : "); 133  hostname = reader.readLine(); 134  System.out.print("Enter username : "); 135  username = reader.readLine(); 136  System.out.print("Enter password : "); 137  password = reader.readLine(); 138  reader.close(); 139   140  SFTPExample example = new SFTPExample(hostname, username, password); 141  example.openConnection(); 142  example.setRemoteDir("/remoteDir"); 143  example.setLocalDir("/localDir"); 144  example.uploadFile("*.*"); 145  example.closeConnection(); 146  } 147  catch(Exception e) 148  { 149  e.printStackTrace(); 150  } 151   152  } 153 } Lines 131 - 138 : Get hostname, username and password from console. Line  140       : Create an instance of SFTPExample. Line  142       : Set the remote directory to upload to. Line  143       : Set the local directory to upload from. Lines 144 - 145 : Upload the file(s) and close the connection to remote server. Line  28        : To recieve events in SFTPExample from SftpAdapter we need to                   add the listener to the SFTPExample instance.

Querying DNS servers with Java

Overview
           The article will demonstrate how to use the dns component in Secure iNet Factory to query dns servers in Java.

           The "Domain Name System" is a distributed database that resides in multiple machines on the Internet and is used to convert between names and addresses and to provide e-mail routing information. Each DNS machine can be queried by other machines and maintains it's own database.

           A machine access a "local name server" which is able to resolve frequently used domain names by caching information. When a local name server is unable to resolve a name it forwards the query to a "root name server". If the root name server is unsuccessful in resolving the name it forwards the query to a "authoritative name server". If a given name server is unable to resolve the name it will forward to another name server, this process will continue until the name is resolved.

Code Example

Download DNSExample.java

               

01 import java.util.*; 02 import com.jscape.inet.dns.*; 03 import com.jscape.inet.dns.record.DnsRecord; 04 05 public class Main { 06  public static void main(String[] args) 07  { 08    try 09  { 10       Dns dns = new Dns(); 11       DnsResponse response = 12          dns.getResponse(new DnsRequest("tesla.comm.toronto.edu", 13                                         "www.utoronto.ca", 14                                         Dns.TYPE_A)); 15       Enumeration e = response.getAnswers(); 16       while(e.hasMoreElements()) 17       { 18          DnsRecord record = (DnsRecord)e.nextElement(); 19          System.out.println(record); 20       } 21    } 22    catch (Exception e) 23    { 24       e.printStackTrace(); 25  } 26 27  } 28 } Lines 1-3   : Necessary import statements. Lines 10-14 : Create the Dns and DnsRequest instance.               The DnsRequest constructor has three arguments.               Argument 1 : Name server. (tesla.comm.toronto.edu)               Argument 2 : The domain name. (www.utoronto.ca)               Argument 3 : Request type. (Dns.TYPE_A)               Dns.Type_A requests  a translation of a name to an IP address. Lines 15-20 : Get the DNS response.               Response when this code was run :               www.utoronto.ca    canonical name = info.utcc.utoronto.ca               info.utcc.utoronto.ca    internet address = 142.150.210.13      We can see that the IP address returned is : "142.150.210.13"

Using FXP with Java

Overview
           FXP is a method of transferring data from one server to another server without routing this data through the client. FTP involves a single client and a single server, FXP on the other hand involves the client having two connections to two different servers (let's call them server A and server B). The client can transfer between these two servers in either direction (from A to B OR from B to A). The obvious advantage of using FXP is that the data transfer is more efficient specially for clients with slow connections.

         One potential disadvantage of using FXP is that the server is vulnerable to "FTP Bounce" attack. More information regarding this can be found here.

Example

Download FXPExample.java

               

01 import com.jscape.inet.ftp.*; 02 03 public class Main 04 { 05  public static void main(String[] args) 06  { 07  String srcHostname = null; 08  String srcUsername = null; 09  String srcPassword = null; 10  String destHostname = null; 11  String destUsername = null; 12  String destPassword = null; 13   14  try 15  { 16  // create source and destination servers 17  Ftp source = new Ftp(srcHostname,srcUsername,srcPassword); 18  Ftp destination = new Ftp(destHostname,destUsername,destPassword); 19  destination.connect(); 20  source.connect(); 21   22  // set source directory of Ftp instance 23  source.setDir("/src"); 24   25  // set destination directory of Ftp instance 26  destination.setDir("/dest"); 27   28  Fxp fxp = new Fxp(); 29  // transfer file "filename.txt" from source to destination 30  fxp.transfer(source,destination,"filename.txt"); 31  // transfer directory "images" from source to destination 32  fxp.transferDir(source,destination,"images"); 33  // transfer files ending with .gif extension from source to destination 34  fxp.mtransfer(source,destination,".*\\.gif"); 35  } 36  catch (Exception e) 37  { 38  e.printStackTrace(); 39  } 40  } 41 } Lines 17-18 : Create source and destination Ftp instances. Line 23     : Set the source directory to transfer from. Line 26     : Set the destination directory to transfer to. Line 28     : Create the Fxp instance. Line 30-31  : Transfer files and directories respectively.

Using Java to zip/unzip files

Overview
              The article will demonstrate how to use the zip component in Secure iNet Factory to zip/unzip files in Java.

Code Example

Download GZIPExample.java

               

01 import java.io.*; 02 import com.jscape.zip.*; 03 04 public class GZIPExample implements ArchiveListener 05 { 06  public static void main(String[] args) 07  { 08  Gzip gzip = new Gzip(); 09  Zip zip = new Zip(); 10   11  // Both zip and Gzip in com.jscape.zip can register with an instance of 12  // ArchiveListener to receive events. 13   14  // Register an instance of ArchiveListener tp GZIP instance 15  // so the GZIP instance can receive events. 16  gzip.addArchiveListener(new GZIPExample()); 17   18  // Register an instance of ArchiveListener tp ZIP instance 19  // so the ZIP instance can receive events. 20  zip.addArchiveListener(new GZIPExample()); 21   22  try 23  { 24  // variables to use the GZIP extension. 25  String inputFile = "TestFile"; 26  String outputFile = "TestFile.gz"; 27   28  // compress an existing file to the specified output file 29  // Argument 1 : Name of the input file. 30  // Argument 2 : Name of the output file 31  gzip.compress(new File(inputFile), new File(outputFile)); 32   33  // decompress an existing archive 34  // Argument 1 : Name of the existing archive 35  // Argument 2 : Destination directory where the uncompressed file will be located. 36  gzip.decompress(new File(outputFile), new File("E:\\")); 37   38  // change the variables to use the ZIP extension. 39  inputFile = "TestFile"; 40  outputFile = "TestFile.zip"; 41   42  // compress an existing file to the specified output file 43  // Argument 1 : Name of the input file. 44  // Argument 2 : Name of the output file 45  zip.compress(new File(inputFile), new File(outputFile)); 46   47  // decompress an existing archive 48  // Argument 1 : Name of the existing archive 49  // Argument 2 : Destination directory where the uncompressed file will be located. 50  zip.decompress(new File(outputFile), new File("E:\\")); 51  } 52  catch (ArchiveException e) 53  { 54  e.printStackTrace(); 55  } 56  } 57 58  // this method is invoked when a file is compressed. 59  public void compressed(ArchiveCompressedEvent argument) 60  { 61  // print out the source object as a string so we know from which 62  // type of object the event came from 63  System.out.println(argument.getSource().toString()); 64   65  File file = argument.getFile(); 66  System.out.println("Compressed file name : " + file.getName()); 67  System.out.println("Compressed file absolute path : " + file.getAbsolutePath()); 68  System.out.println(); 69  } 70 71  // this method is invoked when a file is uncompressed. 72  public void decompressed(ArchiveDecompressedEvent argument) 73  { 74  // print out the source object as a string so we know from which 75  // type of object the event came from 76  System.out.println(argument.getSource().toString()); 77   78  File file = argument.getFile(); 79  System.out.println("Decompressed file name : " + file.getName()); 80  System.out.println("Decompressed file absolute path : " + file.getAbsolutePath()); 81  System.out.println(); 82  } 83 } Lines 1-2   : Necessary imports. Lines 8-9   : Create instances of Gzip and Zip. Lines 31/36 : Compress / Decompress files using the Gzip instance. Lines 45/50 : Compress / Decompress files using the zip instance.               Variables on lines 30/40 need to be changed to the correct               file extension. Lines 59-60 : Compress event is received here. Lines 72-82 : Decompress event is received here.     This code assumes you have a file named "TestFile" under the program directory and you have hard drive labeled "E:\\" on your system. Please change these variable values  before running the program to reflect the correct file-name and location.

Listing remote/local directory contents using SFTP in Java

Overview
              The article will demonstrate how to use the sftp component in Secure FTP Factory to list contents of remote / local directories.

Code Example

Download SFTPListingEx.java

               

001 import java.io.BufferedReader; 002 import java.io.File; 003 import java.io.InputStreamReader; 004 import java.text.SimpleDateFormat; 005 import java.util.*; 006 007 import com.jscape.inet.sftp.*; 008 import com.jscape.inet.sftp.events.*; 009 import com.jscape.inet.ssh.util.SshParameters; 010 011 012 public class SFTPListingEx extends SftpAdapter 013 { 014  private String hostname; 015  private String username; 016  private String password; 017  private Sftp sftp; 018   019  public SFTPListingEx(String hostname, String username, String password) 020  { 021  // initialize local SFTP instance with hostname, username and password. 022  sftp = new Sftp(new SshParameters(hostname, 023  username, 024  password)); 025   026  // register the listener so this instance can recieve events. 027  sftp.addSftpListener(this); 028  } 029   030  // open connection to the remote server. 031  public void openConnection() throws SftpException 032  { 033  sftp.connect(); 034  } 035   036  // disconnect from the remote server. 037  public void closeConnection() 038  { 039  sftp.disconnect(); 040  } 041   042  // set remote directory to upload to 043  public void setRemoteDir(String dir) throws SftpException 044  { 045  sftp.setDir(dir); 046  } 047   048  // set local directory to upload from 049  public void setLocalDir(String dir) 050  { 051  sftp.setLocalDir(new File(dir)); 052  } 053   054  public String GetDirListingAsString() throws SftpException 055  { 056  return sftp.getDirListingAsString(); 057  } 058   059  public Vector GetRemoteDirFiles() throws SftpException 060  { 061  Vector ret = new Vector(); 062  Enumeration listing = sftp.getDirListing(); 063  // enumerate thru listing printing filename for each entry 064  while(listing.hasMoreElements()) 065  { 066  SftpFile f = (SftpFile)listing.nextElement(); 067  ret.add(f.getFilename()); 068  } 069  return ret; 070  } 071   072  // get remote dir listing 073  public Vector GetRemoteDirListing() throws SftpException 074  { 075  Vector ret = new Vector(); 076  Enumeration listing = sftp.getDirListing(); 077  // enumerate thru listing printing filename for each entry 078  while(listing.hasMoreElements()) 079  { 080  ret.add(listing.nextElement()); 081  } 082  return ret; 083  } 084   085  // get local dir listing 086  public Vector GetLocalDirListing() throws SftpException 087  { 088  Vector ret = new Vector(); 089  // get local directory listing 090  Enumeration f = sftp.getLocalDirListing(); 091  while(f.hasMoreElements()) 092  { 093  ret.add(f.nextElement()); 094  } 095  return ret; 096  } 097   098  // this method is invoked when when client connects to the remote server. 099  public void connected(SftpConnectedEvent evt) 100  { 101  System.out.println("Connected to host: " + evt.getHostname()); 102  } 103 104  // this method is invoked when client disconnects from the remote server. 105  public void disconnected(SftpDisconnectedEvent evt) 106  { 107  System.out.println("Disconnected from host: " + evt.getHostname()); 108  } 109   110  public static void main(String[] args) 111  { 112  String hostname = null; 113  String username = null; 114  String password = null; 115  try 116  { 117  BufferedReader reader = new BufferedReader(new InputStreamReader(System.in)); 118  System.out.print("Enter hostname : "); 119  hostname = reader.readLine(); 120  System.out.print("Enter username : "); 121  username = reader.readLine(); 122  System.out.print("Enter password : "); 123  password = reader.readLine(); 124  reader.close(); 125   126  SFTPListingEx example = new SFTPListingEx(hostname, username, password); 127  example.openConnection(); 128  example.setRemoteDir("/remoteDir"); 129  Vector remoteListing = example.GetRemoteDirListing(); 130  example.setLocalDir("/localDir"); 131  Vector localListing = example.GetLocalDirListing(); 132  example.closeConnection(); 133  } 134  catch(Exception e) 135  { 136  e.printStackTrace(); 137  } 138   139  } 140 } Lines 1-9    : Necessary import statements. Line 22      : Initialize sftp instance. Lines 59-70  : Get remote directory file names in a Vector. Lines 73-82  : Get remote directory listing in a Vector. Lines 86-96  : Get local directory listing in a Vector. Lines 99-108 : Events from SftpAdapter.

Communicating with HTTP servers in Java

Overview
               The article will demonstrate how to use the http component in Secure iNet Factory to communicate with Http servers.

Code Example

Download HTTPExample.java

               

001 import com.jscape.inet.http.*; 002 import com.jscape.inet.mime.MimeHeader; 003 004 import java.io.*; 005 import java.util.*; 006 007 public class HTTPExample extends HttpAdapter 008 { 009  HttpRequest request = null; 010  HttpResponse response = null; 011  Http http = null; 012   013  public HTTPExample(String url) throws Exception 014  { 015  // initialize request with the given URL. 016  this.request = new HttpRequest(url); 017  // initialize the Http instance 018  this.http =  new Http(); 019  // add HttpAdapter so this instance can receive events 020  this.http.addHttpListener(this); 021  // get http response 022  this.response = http.getResponse(request); 023  // set timeout before connection is dropped 024  http.setTimeout(5000); 025  } 026   027  // add header to http request 028  public void addHeader(String name, String value) throws Exception 029  { 030  this.request.addHeader(name, value); 031  } 032   033  // add request to http request 034  public void addCookie(String name, String value) 035  { 036  this.request.addCookie(name, value); 037  } 038   039  // set connection timeout 040  public void setTimeOut(int value) 041  { 042  this.http.setTimeout(value); 043  } 044   045  // get response code 046  public int getResponseCode() 047  { 048  return this.response.getResponseCode(); 049  } 050   051  // get http response as a String 052  public String getResponseString() throws Exception 053  { 054  return this.response.getBody(); 055  } 056   057  // get http response as a byte array 058  public byte[] getResponseData() throws Exception 059  { 060  return response.getBodyData(); 061  } 062   063  // this method is called when connection is made 064  public void connected(HttpConnectedEvent event) 065  { 066  System.out.println("Connected to URL: " + event.getURL()); 067  } 068   069  // this method is called when connection is closed 070  public void disconnected(HttpDisconnectedEvent event) 071  { 072  System.out.println("Disconnected from URL: " + event.getURL()); 073  } 074   075  // this event can be used when uploading/downloading large files. 076  public void progress(HttpProgressEvent event) 077  { 078  // process event 079  } 080   081  // print http response headers 082  public void printHeaders() 083  { 084  Enumeration e = response.getHeaders(); 085  while(e.hasMoreElements()) 086  { 087  MimeHeader header = (MimeHeader)e.nextElement(); 088  System.out.println("Name: " + header.getName()); 089  System.out.println("Value: " + header.getValue()); 090  } 091  } 092   093  // print http response cookies. 094  public void printCookies() 095  { 096  try 097  { 098  Enumeration e = response.getCookies(); 099  while(e.hasMoreElements()) 100  { 101  HttpCookie header = (HttpCookie)e.nextElement(); 102  System.out.println("CName: " + header.getCookieName()); 103  System.out.println("CValue: " + header.getCookieValue()); 104  } 105  } 106  catch (Exception e) 107  { 108  e.printStackTrace(); 109  } 110  } 111 112  public static void main(String[] args) 113  { 114  try 115  { 116  // create object instance 117  HTTPExample e = new HTTPExample("http://www.amazon.com"); 118  // get http response as a String 119  String response = e.getResponseString(); 120  System.out.println(response); 121  } 122  catch (Exception e) 123  { 124  e.printStackTrace(); 125  } 126  } 127   128 } Lines 1-5   : Necessary import statements. Line 16     : Initialize HttpRequest. Line 18     : Initialize Http. Line 20     : Add HttpAdapter listener. Line 22     : Get http response. Line 24     : Set connection timeout. Lines 28-31 : Add http header. Lines 34-37 : Add http cookie. Lines 40-43 : Set http connection timeout. Lines 46-49 : Get http response code Lines 52-55 : Get http response as a string. Lines 58-61 : Get http response as a byte array. Lines 63-79 : HttpAdapter events. Lines 82-91 : Print http headers. Lines 94-110 : Print http cookies. For a complete list of HTTP response codes go here. For a complete list of HTTP request headers go here.

Uploading files in HTTP with java

Overview
               This article will demonstrate how to use the http component in Secure iNet Factory to upload files in Java.

Code Example

Download HttpFileUploadEx.java

               

01 import com.jscape.inet.http.Http; 02 import com.jscape.inet.http.*; 03 import java.io.*; 04 05 public class HttpFileUploadEx 06 { 07  public static void main(String[] args) 08  { 09  try 10  { 11  // create new Http instance 12  Http http = new Http(); 13  // create new HttpFileUpload instance 14  HttpFileUpload request = new HttpFileUpload("http://www.myserver.com/cgi-bin/upload.cgi"); 15  // add parameter 16  request.addParameter("name", "John Doe"); 17  // set file data to upload and store as named parameter "picture" 18  request.setFile("picture", "joe.gif", new File("/home/joe/joe.gif")); 19  // upload file and get response 20  HttpResponse response = http.getResponse(request); 21  } 22  catch (Exception e) 23  { 24  e.printStackTrace(); 25  } 26  } 27 } Lines 1-3 : Necessary import statements. Line 12   : Create Http instance. Line 14   : Create HttpFileUpload instance. Line 16   : Add http request parameter. Line 17   : Set file to upload.             Argument1 : fieldName - the name of the field, as specified in                                                                        HTML INPUT         TYPE=FILE tag                         Argument 2  :    fileName - the value to set the MIME filename attribute to                         Argument 3 :     file - the File object of the file to be added For a complete list of HTTP response codes go here. For a complete list of HTTP request headers go here.

Communicating with HTTPS servers in Java

Overview

    This article will demonstrate how to use the https component in Secure iNet Factory to communicate with HTTPS servers.

Retrieving secure web pages using HTTPS

               To retrieve a secure web page using HTTPS you may use the com.jscape.inet.https.Https class.  The Https class is a subclass of the com.jscape.inet.http.Http class so all methods found in the Http class are available in the Https class.  See the Http component documentation for more information on creating HTTP requests.

Setting server and client certificates

              When establishing a connection you may define any optional client certificates that should be used for authentication purposes when establishing an SSL connection.  In addition you may define any optional server certificates that should be validated against to ensure that the server you are communicating with this the server you are expecting.  Client and server certificates should be stored in separate Java keystore files and protected using a keystore password.

              Existing certificates may be imported into a Java keystore using the keytool.exe utility provided with the JDK. 

Example :   keytool.exe -import -file x509.cer -keystore your_store_name

                 The example above imports the certificate x509.cer into a keystore named your_store_name

                 Provided you have existing keystores you may set the client and server certificates using setClientCertificates() and setServerCertificates() methods respectively.

Example : 

// set client certificates

https.setClientCertificates("c:/certs/client_keystore","secret");

// set server certificates

https.setServerCertificates("c:/certs/server_keystore","secret");

Code Example

Download HttpsEx.java

               

01 import java.security.Security; 02 import com.jscape.inet.http.*; 03 import com.jscape.inet.https.Https; 04 05 public class HttpsEx 06 { 07  public static void main(String[] args) 08  { 09  try 10  { 11  // The following example demonstrates using the 12  // Https class with JDK 1.4 and above. 13  // create request 14  HttpRequest request = new HttpRequest("https://www.myserver.com"); 15  // create new Https instance 16  Https https = new Https(); 17  // get response 18  HttpResponse response = https.getResponse(request); 19   20  /*********************************************************************/ 21   22  // The following example demonstrates using the 23  // Https class with JDK 1.3.x and the JCE. 24  // register SSL provider 25  Security.addProvider(new com.sun.net.ssl.internal.ssl.Provider()); 26  // create request 27  request = new HttpRequest("https://www.myserver.com"); 28  // create new Https instance 29  https = new Https(); 30  // get response 31  response = https.getResponse(request); 32   33  } 34  catch (Exception e) 35  { 36  e.printStackTrace(); 37  } 38  } 39 } Lines 1-3 : Necessary import statements. Lines 11-18 : Use this code with JDK 1.4 and above. Lines 22-31 : Use this code with JDK 1.3.x and JCE