com.conveyal.gtfs.loader

Class JdbcTableWriter

java.lang.Object

com.conveyal.gtfs.loader.JdbcTableWriter

All Implemented Interfaces:

TableWriter

public class JdbcTableWriter
extends Object
implements TableWriter

This wraps a single database table and provides methods to modify GTFS entities.

Constructor Summary

Constructors

Constructor and Description
JdbcTableWriter(Table table, DataSource datasource, String namespace)
JdbcTableWriter(Table specTable, DataSource dataSource, String tablePrefix, Connection optionalConnection)

Method Summary

Modifier and Type	Method and Description
void	close() Ensure that database connection closes.
void	commit()
String	create(String json, boolean autoCommit) Create a new entity in the database from the provided JSON string.
int	delete(Integer id, boolean autoCommit) Deletes an entity for the specified ID.
int	deleteWhere(String fieldName, String value, boolean autoCommit) For a given condition (fieldName = 'value'), delete all entities that match the condition.
int	normalizeStopTimesForPattern(int id, int beginWithSequence) For a given pattern id and starting stop sequence (inclusive), normalize all stop times to match the pattern stops' travel times.
String	update(Integer id, String json, boolean autoCommit) Update entity for a given ID with the provided JSON string.

Methods inherited from class java.lang.Object

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

Constructor Detail

JdbcTableWriter

public JdbcTableWriter(Table table,
                       DataSource datasource,
                       String namespace)
                throws InvalidNamespaceException

Throws:

InvalidNamespaceException

JdbcTableWriter

public JdbcTableWriter(Table specTable,
                       DataSource dataSource,
                       String tablePrefix,
                       Connection optionalConnection)
                throws InvalidNamespaceException

Throws:

InvalidNamespaceException

Method Detail

create

public String create(String json,
                     boolean autoCommit)
              throws SQLException,
                     IOException

Create a new entity in the database from the provided JSON string. Note, any call to create or update must provide a JSON string with the full set of fields matching the definition of the GTFS table in the Table class.

Specified by:

create in interface TableWriter

Throws:

SQLException

IOException

update

public String update(Integer id,
                     String json,
                     boolean autoCommit)
              throws SQLException,
                     IOException

Update entity for a given ID with the provided JSON string. This update and any potential cascading updates to referencing tables all happens in a single transaction. Note, any call to create or update must provide a JSON string with the full set of fields matching the definition of the GTFS table in the Table class.

Specified by:

update in interface TableWriter

Throws:

SQLException

IOException

normalizeStopTimesForPattern

public int normalizeStopTimesForPattern(int id,
                                        int beginWithSequence)
                                 throws SQLException

For a given pattern id and starting stop sequence (inclusive), normalize all stop times to match the pattern stops' travel times.

Returns:

number of stop times updated

Throws:

SQLException

deleteWhere

public int deleteWhere(String fieldName,
                       String value,
                       boolean autoCommit)
                throws SQLException

For a given condition (fieldName = 'value'), delete all entities that match the condition. Because this uses the delete(Integer, boolean) method, it also will delete any "child" entities that reference any entities matching the original query.

Specified by:

deleteWhere in interface TableWriter

Throws:

SQLException

delete

public int delete(Integer id,
                  boolean autoCommit)
           throws SQLException

Deletes an entity for the specified ID.

Specified by:

delete in interface TableWriter

Throws:

SQLException

commit

public void commit()
            throws SQLException

Specified by:

commit in interface TableWriter

Throws:

SQLException

close

public void close()

Ensure that database connection closes. This should be called once the table writer is no longer needed.

Specified by:

close in interface TableWriter