uk.ac.starlink.pds4

Class SafeFieldAdapter

java.lang.Object

uk.ac.starlink.pds4.SafeFieldAdapter

All Implemented Interfaces:

gov.nasa.pds.objectAccess.table.FieldAdapter

public class SafeFieldAdapter
extends java.lang.Object
implements gov.nasa.pds.objectAccess.table.FieldAdapter

Wrapper for FieldAdapter that catches and logs RuntimeExceptions. Probably such exceptions ought not to happen, but for instance NumberFormatExceptions are not impossible, and it may be preferred to log them than for the entire table read to fail.

Currently only the get* methods are so wrapped, since the set* methods are (a) less likely to encounter problems from data and (b) not used by this package.

Since:

10 Nov 2022

Constructor Summary

Constructors

Constructor and Description
SafeFieldAdapter(gov.nasa.pds.objectAccess.table.FieldAdapter base) Constructor.

Method Summary

Modifier and Type	Method and Description
java.math.BigInteger	getBigInteger(byte[] buf, int offset, int length, int startBit, int stopBit)
byte	getByte(byte[] buf, int offset, int length, int startBit, int stopBit)
double	getDouble(byte[] buf, int offset, int length, int startBit, int stopBit)
float	getFloat(byte[] buf, int offset, int length, int startBit, int stopBit)
int	getInt(byte[] buf, int offset, int length, int startBit, int stopBit)
long	getLong(byte[] buf, int offset, int length, int startBit, int stopBit)
short	getShort(byte[] buf, int offset, int length, int startBit, int stopBit)
java.lang.String	getString(byte[] buf, int offset, int length, int startBit, int stopBit)
java.lang.String	getString(byte[] buf, int offset, int length, int startBit, int stopBit, java.nio.charset.Charset charset)
void	setBigInteger(java.math.BigInteger value, int offset, int length, java.nio.ByteBuffer buf, boolean isRightJustified)
void	setByte(byte value, int offset, int length, java.nio.ByteBuffer buf, boolean isRightJustified)
void	setDouble(double value, int offset, int length, java.nio.ByteBuffer buf, boolean isRightJustified)
void	setFloat(float value, int offset, int length, java.nio.ByteBuffer buf, boolean isRightJustified)
void	setInt(int value, int offset, int length, java.nio.ByteBuffer buffer, boolean isRightJustified)
void	setLong(long value, int offset, int length, java.nio.ByteBuffer buf, boolean isRightJustified)
void	setShort(short value, int offset, int length, java.nio.ByteBuffer buf, boolean isRightJustified)
void	setString(java.lang.String value, int offset, int length, java.nio.ByteBuffer buf, boolean isRightJustified)
void	setString(java.lang.String value, int offset, int length, java.nio.ByteBuffer buf, boolean isRightJustified, java.nio.charset.Charset charset)

Methods inherited from class java.lang.Object

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

Constructor Detail

SafeFieldAdapter

public SafeFieldAdapter(gov.nasa.pds.objectAccess.table.FieldAdapter base)

Constructor.

Parameters:

base - instance on which this object's behaviour is based

Method Detail

getByte

public byte getByte(byte[] buf,
                    int offset,
                    int length,
                    int startBit,
                    int stopBit)

Specified by:

getByte in interface gov.nasa.pds.objectAccess.table.FieldAdapter

getShort

public short getShort(byte[] buf,
                      int offset,
                      int length,
                      int startBit,
                      int stopBit)

Specified by:

getShort in interface gov.nasa.pds.objectAccess.table.FieldAdapter

getInt

public int getInt(byte[] buf,
                  int offset,
                  int length,
                  int startBit,
                  int stopBit)

Specified by:

getInt in interface gov.nasa.pds.objectAccess.table.FieldAdapter

getLong

public long getLong(byte[] buf,
                    int offset,
                    int length,
                    int startBit,
                    int stopBit)

Specified by:

getLong in interface gov.nasa.pds.objectAccess.table.FieldAdapter

getBigInteger

public java.math.BigInteger getBigInteger(byte[] buf,
                                          int offset,
                                          int length,
                                          int startBit,
                                          int stopBit)

Specified by:

getBigInteger in interface gov.nasa.pds.objectAccess.table.FieldAdapter

getFloat

public float getFloat(byte[] buf,
                      int offset,
                      int length,
                      int startBit,
                      int stopBit)

Specified by:

getFloat in interface gov.nasa.pds.objectAccess.table.FieldAdapter

getDouble

public double getDouble(byte[] buf,
                        int offset,
                        int length,
                        int startBit,
                        int stopBit)

Specified by:

getDouble in interface gov.nasa.pds.objectAccess.table.FieldAdapter

getString

public java.lang.String getString(byte[] buf,
                                  int offset,
                                  int length,
                                  int startBit,
                                  int stopBit)

Specified by:

getString in interface gov.nasa.pds.objectAccess.table.FieldAdapter

getString

public java.lang.String getString(byte[] buf,
                                  int offset,
                                  int length,
                                  int startBit,
                                  int stopBit,
                                  java.nio.charset.Charset charset)

Specified by:

getString in interface gov.nasa.pds.objectAccess.table.FieldAdapter

setString

public void setString(java.lang.String value,
                      int offset,
                      int length,
                      java.nio.ByteBuffer buf,
                      boolean isRightJustified)

Specified by:

setString in interface gov.nasa.pds.objectAccess.table.FieldAdapter

setString

public void setString(java.lang.String value,
                      int offset,
                      int length,
                      java.nio.ByteBuffer buf,
                      boolean isRightJustified,
                      java.nio.charset.Charset charset)

Specified by:

setString in interface gov.nasa.pds.objectAccess.table.FieldAdapter

setInt

public void setInt(int value,
                   int offset,
                   int length,
                   java.nio.ByteBuffer buffer,
                   boolean isRightJustified)

Specified by:

setInt in interface gov.nasa.pds.objectAccess.table.FieldAdapter

setDouble

public void setDouble(double value,
                      int offset,
                      int length,
                      java.nio.ByteBuffer buf,
                      boolean isRightJustified)

Specified by:

setDouble in interface gov.nasa.pds.objectAccess.table.FieldAdapter

setFloat

public void setFloat(float value,
                     int offset,
                     int length,
                     java.nio.ByteBuffer buf,
                     boolean isRightJustified)

Specified by:

setFloat in interface gov.nasa.pds.objectAccess.table.FieldAdapter

setShort

public void setShort(short value,
                     int offset,
                     int length,
                     java.nio.ByteBuffer buf,
                     boolean isRightJustified)

Specified by:

setShort in interface gov.nasa.pds.objectAccess.table.FieldAdapter

setByte

public void setByte(byte value,
                    int offset,
                    int length,
                    java.nio.ByteBuffer buf,
                    boolean isRightJustified)

Specified by:

setByte in interface gov.nasa.pds.objectAccess.table.FieldAdapter

setLong

public void setLong(long value,
                    int offset,
                    int length,
                    java.nio.ByteBuffer buf,
                    boolean isRightJustified)

Specified by:

setLong in interface gov.nasa.pds.objectAccess.table.FieldAdapter

setBigInteger

public void setBigInteger(java.math.BigInteger value,
                          int offset,
                          int length,
                          java.nio.ByteBuffer buf,
                          boolean isRightJustified)

Specified by:

setBigInteger in interface gov.nasa.pds.objectAccess.table.FieldAdapter