Package org.tailormap.api.geotools.featuresources

Class AttachmentsHelper

java.lang.Object

org.tailormap.api.geotools.featuresources.AttachmentsHelper

public final class AttachmentsHelper
extends Object

Helper class for managing the <FT>_attachments sidecar tables in JDBC DataStores.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final record	AttachmentsHelper.AttachmentWithBinary

Method Summary

Modifier and Type	Method	Description
static void	createAttachmentTableForFeatureType(TMFeatureType featureType)	Create attachment table and index for the given FeatureType.
static void	deleteAttachment(UUID attachmentId, TMFeatureType featureType)
static void	dropAttachmentTableForFeatureType(TMFeatureType featureType)
static AttachmentsHelper.AttachmentWithBinary	getAttachment(TMFeatureType featureType, UUID attachmentId)
static AttachmentMetadata	insertAttachment(TMFeatureType featureType, AttachmentMetadata attachment, Object primaryKey, byte[] fileData)
static List<AttachmentMetadata>	listAttachmentsForFeature(TMFeatureType featureType, Object primaryKey)
static Map<@NotNull Object,List<AttachmentMetadata>>	listAttachmentsForFeaturesByFeatureId(TMFeatureType featureType, List<Object> featurePKs)	List attachments for multiple features grouped by their IDs.

Methods inherited from class java.lang.Object

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

Method Details

createAttachmentTableForFeatureType

public static void createAttachmentTableForFeatureType(TMFeatureType featureType)
                                                throws IOException,
SQLException,
IllegalArgumentException

Create attachment table and index for the given FeatureType. This will validate that any AttachmentAttribute has a valid name.

Parameters:

featureType - the FeatureType to create the attachment table for

Throws:

IOException - when creating the GeoTools datastore fails

SQLException - when executing the SQL statements fails

IllegalArgumentException - when the FeatureType is invalid

dropAttachmentTableForFeatureType

public static void dropAttachmentTableForFeatureType(TMFeatureType featureType)
                                              throws IOException,
SQLException

Throws:

IOException

SQLException

insertAttachment

public static AttachmentMetadata insertAttachment(TMFeatureType featureType,
 AttachmentMetadata attachment,
 Object primaryKey,
 byte[] fileData)
                                           throws IOException,
SQLException

Throws:

IOException

SQLException

deleteAttachment

public static void deleteAttachment(UUID attachmentId,
 TMFeatureType featureType)
                             throws IOException,
SQLException

Throws:

IOException

SQLException

listAttachmentsForFeature

public static List<AttachmentMetadata> listAttachmentsForFeature(TMFeatureType featureType,
 Object primaryKey)
                                                          throws IOException,
SQLException

Throws:

IOException

SQLException

getAttachment

public static AttachmentsHelper.AttachmentWithBinary getAttachment(TMFeatureType featureType,
 UUID attachmentId)
                                                            throws IOException,
SQLException

Throws:

IOException

SQLException

listAttachmentsForFeaturesByFeatureId

public static Map<@NotNull Object,List<AttachmentMetadata>> listAttachmentsForFeaturesByFeatureId(TMFeatureType featureType,
 List<Object> featurePKs)
                                                                                           throws IOException

List attachments for multiple features grouped by their IDs.
NOTE: the featurePKs list should contain Comparable objects (e.g. no byte[]), as these are used as map keys. E.g. byte[] is converted to ByteBuffer.

TODO: HTM-1771

Parameters:

featureType - the feature type

featurePKs - the feature primary keys

Returns:

map of feature ID to list of attachments

Throws:

IOException - when an IO error occurs connecting to the database