Package nom.tam.fits

Class FitsUtil


  • public final class FitsUtil
    extends java.lang.Object
    This class comprises static utility functions used throughout the FITS classes.
    • Method Summary

      All Methods Static Methods Concrete Methods 
      Modifier and Type Method Description
      static int addPadding​(int size)  
      static long addPadding​(long size)  
      static java.lang.String[] byteArrayToStrings​(byte[] bytes, int maxLen)  
      static long findOffset​(java.io.Closeable o)  
      static java.io.InputStream getURLStream​(java.net.URL url, int level)  
      static int maxLength​(java.lang.String[] strings)  
      static void pad​(ArrayDataOutput stream, long size)
      Add padding to an output stream.
      static void pad​(ArrayDataOutput stream, long size, byte fill)
      Add padding to an output stream.
      static int padding​(int size)  
      static int padding​(long size)  
      static void reposition​(java.io.Closeable o, long offset)
      Reposition a random access stream to a requested offset.
      static byte[] stringsToByteArray​(java.lang.String[] stringArray, int maxLen)
      Convert an array of Strings to bytes.
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Method Detail

      • addPadding

        public static int addPadding​(int size)
        Parameters:
        size - the current size.
        Returns:
        Total size of blocked FITS element, using e.v. padding to fits block size.
      • addPadding

        public static long addPadding​(long size)
        Parameters:
        size - the current size.
        Returns:
        Total size of blocked FITS element, using e.v. padding to fits block size.
      • byteArrayToStrings

        public static java.lang.String[] byteArrayToStrings​(byte[] bytes,
                                                            int maxLen)
        Parameters:
        bytes - byte array to convert
        maxLen - the max string length
        Returns:
        Convert bytes to Strings.
      • findOffset

        public static long findOffset​(java.io.Closeable o)
        Parameters:
        o - the stream to get the position
        Returns:
        Find out where we are in a random access file .
      • getURLStream

        public static java.io.InputStream getURLStream​(java.net.URL url,
                                                       int level)
                                                throws java.io.IOException
        Parameters:
        url - the url to get the stream from
        level - max levels of redirection
        Returns:
        Get a stream to a URL accommodating possible redirections. Note that if a redirection request points to a different protocol than the original request, then the redirection is not handled automatically.
        Throws:
        java.io.IOException - if the operation failed
      • maxLength

        public static int maxLength​(java.lang.String[] strings)
                             throws FitsException
        Parameters:
        strings - array of strings to check
        Returns:
        Get the maximum length of a String in a String array.
        Throws:
        FitsException - if the operation failed
      • pad

        public static void pad​(ArrayDataOutput stream,
                               long size)
                        throws FitsException
        Add padding to an output stream.
        Parameters:
        stream - stream to pad
        size - the current size
        Throws:
        FitsException - if the operation failed
      • pad

        public static void pad​(ArrayDataOutput stream,
                               long size,
                               byte fill)
                        throws FitsException
        Add padding to an output stream.
        Parameters:
        stream - stream to pad
        size - the current size
        fill - the fill byte to use
        Throws:
        FitsException - if the operation failed
      • padding

        public static int padding​(int size)
        Parameters:
        size - the size without padding
        Returns:
        How many bytes are needed to fill a 2880 block?
      • padding

        public static int padding​(long size)
      • reposition

        public static void reposition​(java.io.Closeable o,
                                      long offset)
                               throws FitsException
        Reposition a random access stream to a requested offset.
        Parameters:
        o - the closable to reposition
        offset - the offset to position it to.
        Throws:
        FitsException - if the operation was failed or not possible
      • stringsToByteArray

        public static byte[] stringsToByteArray​(java.lang.String[] stringArray,
                                                int maxLen)
        Convert an array of Strings to bytes.
        Parameters:
        stringArray - the array with Strings
        maxLen - the max length (in bytes) of every String
        Returns:
        the resulting bytes