Overview  Package   Class  Use  Tree  Deprecated  Index  Help 
 PREV CLASS   NEXT CLASS FRAMES    NO FRAMES    
SUMMARY: NESTED | FIELD | CONSTR | METHOD DETAIL: FIELD | CONSTR | METHOD

uk.org.ogsadai.common
Class NetUtilities

java.lang.Object
  |
  +--uk.org.ogsadai.common.NetUtilities
public class NetUtilities
extends java.lang.Object

Contains helper methods relating to the java.net package, such as methods to read data from URLs.

Author:
The OGSA-DAI Project Team

Field Summary
private static java.lang.String COPYRIGHT_NOTICE
           
 
Constructor Summary
NetUtilities()
           
 
Method Summary
static java.lang.String getMachineIPAddress()
          Retrieve the IP address of the machine which is running the activity
static org.w3c.dom.Document readToDocument(java.lang.String url, boolean validate)
          Returns a string containing the data read from a specified URL.
static java.lang.String readToString(java.lang.String url)
          Returns a string containing the data read from a specified URL.
static java.lang.String readToString(java.net.URL url)
          Returns a string containing the data read from a specified URL.
static boolean sameFile(java.net.URL url1, java.net.URL url2)
          Return a flag indicating whether two file URLs point to the same file.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

COPYRIGHT_NOTICE

private static final java.lang.String COPYRIGHT_NOTICE
See Also:
Constant Field Values
Constructor Detail

NetUtilities

public NetUtilities()
Method Detail

readToDocument

public static org.w3c.dom.Document readToDocument(java.lang.String url,
                                                  boolean validate)
                                           throws DAIMalformedURLException,
                                                  DAIURLReadIOException,
                                                  XMLParseException
Returns a string containing the data read from a specified URL.

Note that special care is needed when expressing file URLs. The following forms are acceptable: file:/C:/hello.txt or file:///C:/hello.txt but not file://C:/hello.txt.

Parameters:
url - The URL to read.
validate - Validate the document.
Returns:
a String containing the data read from the URL.
Throws:
DAIMalformedURLException - if the URL is malformed.
DAIURLReadIOException - if there is a problem reading the URL.
XMLParseException - if there is a problem with the XML.
See Also:
readToString(java.net.URL), XMLUtilities.xmlStringToDOM(java.lang.String, boolean)

readToString

public static java.lang.String readToString(java.lang.String url)
                                     throws DAIMalformedURLException,
                                            DAIURLReadIOException
Returns a string containing the data read from a specified URL.

Note that special care is needed when expressing file URLs. The following forms are acceptable: file:/C:/hello.txt or file:///C:/hello.txt but not file://C:/hello.txt.

Parameters:
url - The URL to read.
Returns:
a String containing the data read from the URL.
Throws:
DAIMalformedURLException - if the URL is malformed.
DAIURLReadIOException - if there is a problem reading the URL.
See Also:
readToString(java.net.URL)

readToString

public static java.lang.String readToString(java.net.URL url)
                                     throws DAIURLReadIOException
Returns a string containing the data read from a specified URL.

Note that special care is needed when expressing file URLs. The following forms are acceptable: file:/C:/hello.txt or file:///C:/hello.txt but not file://C:/hello.txt.

Parameters:
url - The URL to read.
Returns:
a Document containing the data read from the URL.
Throws:
DAIURLReadIOException - if there is a problem reading the URL.

sameFile

public static boolean sameFile(java.net.URL url1,
                               java.net.URL url2)
Return a flag indicating whether two file URLs point to the same file.

Parameters:
url1 - First file URL.
url2 - Second file URL.
Returns:
true if both URLs point to the same file, otherwise return false

getMachineIPAddress

public static java.lang.String getMachineIPAddress()
                                            throws java.net.UnknownHostException
Retrieve the IP address of the machine which is running the activity

Returns:
IP address
Throws:
java.net.UnknownHostException - If there was a problem retrieving the host address
Overview  Package   Class  Use  Tree  Deprecated  Index  Help 
 PREV CLASS   NEXT CLASS FRAMES    NO FRAMES    
SUMMARY: NESTED | FIELD | CONSTR | METHOD DETAIL: FIELD | CONSTR | METHOD