uk.ac.starlink.xdoc

Class XdocUtils

java.lang.Object

uk.ac.starlink.xdoc.XdocUtils

public class XdocUtils
extends Object

Utilities designed for use during XSTL processing. These generally provide some kind of processing based on the values of strings which return strings for insertion into a document. They can be used in conjunction with Xalan's XSLT processing by adding the attribute

    xmlns:XdocUtils="xalan://uk.ac.starlink.xdoc.XdocUtils"
 

to the xsl:stylesheet element of an XSLT stylesheet. Other processors probably have their own mechanisms.

Since:

20 Feb 2006

Author:

Mark Taylor

Method Summary

Modifier and Type	Method and Description
static String	classUsage(String clazzName) Returns the usage string for a given class.
static Dimension	getImageSize(String fname) Returns the dimensions of an image file with the given filename.
static String	reportFileSize(String loc) Returns the approximate size of a file in human-readable form given the location of a file.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

classUsage

public static String classUsage(String clazzName)
                         throws ClassNotFoundException,
                                NoSuchMethodException,
                                IllegalAccessException,
                                InvocationTargetException

Returns the usage string for a given class. It invokes the main(String[]) method of the named class with the single argument "-help", and captures and returns the output.

Parameters:

clazzName - fully qualified name of class having main() method

Returns:

usage string

Throws:

ClassNotFoundException

NoSuchMethodException

IllegalAccessException

InvocationTargetException

reportFileSize

public static String reportFileSize(String loc)

Returns the approximate size of a file in human-readable form given the location of a file.

Parameters:

loc - file location

Returns:

file file length string, such as "5.6M"

getImageSize

public static Dimension getImageSize(String fname)
                              throws IOException

Returns the dimensions of an image file with the given filename. If no dimensions can be established, a message is reported through the logging system, and a Dimension object with negative dimensions is returned.

Parameters:

fname - filename of image file

Returns:

dimensions of image, or dummy new Dimension(-1,-1)

Throws:

IOException