Java tutorial
/* * Copyright (C) 2007 ETH Zurich * * This file is part of Fosstrak (www.fosstrak.org). * * Fosstrak is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License version 2.1, as published by the Free Software Foundation. * * Fosstrak is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with Fosstrak; if not, write to the Free * Software Foundation, Inc., 51 Franklin Street, Fifth Floor, * Boston, MA 02110-1301 USA */ package org.fosstrak.epcis.repository.capture; import java.io.BufferedReader; import java.io.FileReader; import java.io.IOException; import java.sql.Connection; import java.sql.PreparedStatement; import java.sql.ResultSet; import java.sql.SQLException; import java.sql.Statement; import java.sql.Timestamp; import java.util.ArrayList; import java.util.HashMap; import java.util.List; import java.util.Map; import javax.sql.DataSource; import org.fosstrak.epcis.model.BusinessTransactionType; import org.fosstrak.epcis.repository.EpcisConstants; import org.fosstrak.epcis.repository.model.EventFieldExtension; import org.apache.commons.logging.Log; import org.apache.commons.logging.LogFactory; /** * The CaptureOperationsBackendSQL uses basic SQL statements (actually * <code>PreparedStatement</code>s) to implement the CaptureOperationsBackend * interface. * * @author Alain Remund * @author Marco Steybe * @author Sean Wellington */ public class CaptureOperationsBackendSQL implements CaptureOperationsBackend { private static final Log LOG = LogFactory.getLog(CaptureOperationsBackendSQL.class); private static final String SQL_INSERT_AGGREGATIONEVENT = "INSERT INTO event_AggregationEvent (eventTime, recordTime, eventTimeZoneOffset, bizStep, disposition, readPoint, bizLocation, action, parentID) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)"; private static final String SQL_INSERT_OBJECTEVENT = "INSERT INTO event_ObjectEvent (eventTime, recordTime, eventTimeZoneOffset, bizStep, disposition, readPoint, bizLocation, action VALUES (?, ?, ?, ?, ?, ?, ?, ?)"; private static final String SQL_INSERT_QUANTITYEVENT = "INSERT INTO event_QuantityEvent (eventTime, recordTime, eventTimeZoneOffset, bizStep, disposition, readPoint, bizLocation, epcClass, quantity) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)"; private static final String SQL_INSERT_TRANSACTIONEVENT = "INSERT INTO event_TransactionEvent (eventTime, recordTime, eventTimeZoneOffset, bizStep, disposition, readPoint, bizLocation, action, parentID) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)"; private static Map<String, String> VOCABTYPE_TABLENAME_MAP; static { VOCABTYPE_TABLENAME_MAP = new HashMap<String, String>(); VOCABTYPE_TABLENAME_MAP.put(EpcisConstants.DISPOSITION_ID, "voc_Disposition"); VOCABTYPE_TABLENAME_MAP.put(EpcisConstants.READ_POINT_ID, "voc_ReadPoint"); VOCABTYPE_TABLENAME_MAP.put(EpcisConstants.EPC_CLASS_ID, "voc_EPCClass"); VOCABTYPE_TABLENAME_MAP.put(EpcisConstants.BUSINESS_LOCATION_ID, "voc_BizLoc"); VOCABTYPE_TABLENAME_MAP.put(EpcisConstants.BUSINESS_STEP_ID, "voc_BizStep"); VOCABTYPE_TABLENAME_MAP.put(EpcisConstants.BUSINESS_TRANSACTION_TYPE_ID, "voc_BizTransType"); VOCABTYPE_TABLENAME_MAP.put(EpcisConstants.BUSINESS_TRANSACTION_ID, "voc_BizTrans"); } /** * {@inheritDoc} */ public void dbReset(final Connection dbconnection, final String dbResetScript) throws SQLException, IOException { LOG.info("Running db reset script."); Statement stmt = null; BufferedReader reader = null; try { stmt = dbconnection.createStatement(); if (dbResetScript != null) { reader = new BufferedReader(new FileReader(dbResetScript)); String line; while ((line = reader.readLine()) != null) { stmt.addBatch(line); } } stmt.executeBatch(); } finally { if (stmt != null) { stmt.close(); } if (reader != null) { reader.close(); } } } /** * {@inheritDoc} */ public CaptureOperationsSession openSession(final DataSource dataSource) throws SQLException { return new CaptureOperationsSession(dataSource.getConnection()); } /** * {@inheritDoc} */ public Long insertObjectEvent(final CaptureOperationsSession session, final Timestamp eventTime, final Timestamp recordTime, final String eventTimeZoneOffset, final Long bizStepId, final Long dispositionId, final Long readPointId, final Long bizLocationId, final String action) throws SQLException { return insertEvent(session, eventTime, recordTime, eventTimeZoneOffset, bizStepId, dispositionId, readPointId, bizLocationId, action, null, null, null, EpcisConstants.OBJECT_EVENT); } /** * {@inheritDoc} */ public Long insertTransactionEvent(final CaptureOperationsSession session, final Timestamp eventTime, final Timestamp recordTime, final String eventTimeZoneOffset, final Long bizStepId, final Long dispositionId, final Long readPointId, final Long bizLocationId, final String action, final String parentId) throws SQLException { return insertEvent(session, eventTime, recordTime, eventTimeZoneOffset, bizStepId, dispositionId, readPointId, bizLocationId, action, parentId, null, null, EpcisConstants.TRANSACTION_EVENT); } /** * {@inheritDoc} */ public Long insertAggregationEvent(final CaptureOperationsSession session, final Timestamp eventTime, final Timestamp recordTime, final String eventTimeZoneOffset, final Long bizStepId, final Long dispositionId, final Long readPointId, final Long bizLocationId, final String action, final String parentId) throws SQLException { return insertEvent(session, eventTime, recordTime, eventTimeZoneOffset, bizStepId, dispositionId, readPointId, bizLocationId, action, parentId, null, null, EpcisConstants.AGGREGATION_EVENT); } /** * {@inheritDoc} */ public Long insertQuantityEvent(final CaptureOperationsSession session, final Timestamp eventTime, final Timestamp recordTime, final String eventTimeZoneOffset, final Long bizStepId, final Long dispositionId, final Long readPointId, final Long bizLocationId, final Long epcClassId, final Long quantity) throws SQLException { return insertEvent(session, eventTime, recordTime, eventTimeZoneOffset, bizStepId, dispositionId, readPointId, bizLocationId, null, null, epcClassId, quantity, EpcisConstants.QUANTITY_EVENT); } /** * Inserts a new EPCIS event into the database by supplying a * PreparedStatement with the given parameters. * * @param session * The database session. * @param eventTime * The event's 'eventTime' parameter. * @param recordTime * The event's 'recordTime' parameter. * @param eventTimeZoneOffset * The event's 'eventTimeZoneOffset' parameter. * @param bizStepId * The event's 'BusinessStepID' parameter. * @param dispositionId * The event's 'DispositionID' parameter. * @param readPointId * The event's 'ReadPointID' parameter. * @param bizLocationId * The event's 'BusinessLocationID' parameter. * @param action * The event's 'action' parameter. * @param parentId * The event's 'ParentID' parameter. * @param epcClassId * The event's 'EpcClassID' parameter. * @param quantity * The event's 'quantity' parameter. * @param eventName * The name of the event. * @return The database primary key of the inserted EPCIS event. * @throws SQLException * If an SQL exception occurred. */ private Long insertEvent(final CaptureOperationsSession session, final Timestamp eventTime, final Timestamp recordTime, final String eventTimeZoneOffset, final Long bizStepId, final Long dispositionId, final Long readPointId, final Long bizLocationId, final String action, final String parentId, final Long epcClassId, final Long quantity, final String eventName) throws SQLException { PreparedStatement ps; if (eventName.equals(EpcisConstants.AGGREGATION_EVENT)) { ps = session.getInsert(SQL_INSERT_AGGREGATIONEVENT); } else if (eventName.equals(EpcisConstants.OBJECT_EVENT)) { ps = session.getInsert(SQL_INSERT_OBJECTEVENT); } else if (eventName.equals(EpcisConstants.QUANTITY_EVENT)) { ps = session.getInsert(SQL_INSERT_QUANTITYEVENT); } else if (eventName.equals(EpcisConstants.TRANSACTION_EVENT)) { ps = session.getInsert(SQL_INSERT_TRANSACTIONEVENT); } else { throw new SQLException("Encountered unknown event element '" + eventName + "'."); } // parameters 1-7 of the sql query are shared by all events ps.setTimestamp(1, eventTime); // according to the specification: recordTime is the time of capture ps.setTimestamp(2, recordTime != null ? recordTime : new Timestamp(System.currentTimeMillis())); // note: for testing it is handy to set recordTime=eventTime // ps.setTimestamp(2, eventTime); ps.setString(3, eventTimeZoneOffset); if (bizStepId != null) { ps.setLong(4, bizStepId.longValue()); } else { ps.setNull(4, java.sql.Types.BIGINT); } if (dispositionId != null) { ps.setLong(5, dispositionId.longValue()); } else { ps.setNull(5, java.sql.Types.BIGINT); } if (readPointId != null) { ps.setLong(6, readPointId.longValue()); } else { ps.setNull(6, java.sql.Types.BIGINT); } if (bizLocationId != null) { ps.setLong(7, bizLocationId.longValue()); } else { ps.setNull(7, java.sql.Types.BIGINT); } // special handling for QuantityEvent if (eventName.equals("QuantityEvent")) { if (epcClassId != null) { ps.setLong(8, epcClassId.longValue()); } else { ps.setNull(8, java.sql.Types.BIGINT); } if (quantity != null) { ps.setLong(9, quantity.longValue()); } else { ps.setNull(9, java.sql.Types.BIGINT); } } else { // all other events have action ps.setString(8, action); // AggregationEvent and TransactionEvent have a parentID field if (eventName.equals("AggregationEvent") || eventName.equals("TransactionEvent")) { ps.setString(9, parentId); } } ps.executeUpdate(); session.commit(); return getLastAutoIncrementedId(session, "event_" + eventName); } /** * Retrieves the last inserted ID chosen by the autoIncrement functionality * in the table with the given name. * * @param session * The database session. * @param tableName * The name of the table for which the last inserted ID should be * retrieved. * @return The last auto incremented ID. * @throws SQLException * If an SQL problem with the database occurred. */ private Long getLastAutoIncrementedId(final CaptureOperationsSession session, final String tableName) throws SQLException { String stmt = "SELECT LAST_INSERT_ID() as id FROM " + tableName; PreparedStatement ps = session.getSelect(stmt); ResultSet rs = null; try { rs = ps.executeQuery(); rs.next(); return Long.valueOf(rs.getLong("id")); } finally { if (rs != null) { rs.close(); } } } /** * {@inheritDoc} */ public void insertEpcsForEvent(final CaptureOperationsSession session, final long eventId, final String eventType, final List<String> epcs) throws SQLException { // preparing statement for insertion of associated EPCs String insert = "INSERT INTO event_" + eventType + "_EPCs (event_id, epc) VALUES (?, ?)"; PreparedStatement ps = session.getBatchInsert(insert); LOG.debug("INSERT: " + insert); // insert all EPCs in the EPCs array for (String epc : epcs) { if (LOG.isDebugEnabled()) { LOG.debug(" insert param 1: " + eventId); LOG.debug(" insert param 2: " + epc.toString()); } ps.setLong(1, eventId); ps.setString(2, epc.toString()); ps.addBatch(); } } /** * {@inheritDoc} */ public Long getVocabularyElement(final CaptureOperationsSession session, final String vocabularyType, final String vocabularyElement) throws SQLException { String stmt = "SELECT id FROM " + VOCABTYPE_TABLENAME_MAP.get(vocabularyType) + " WHERE uri=?"; PreparedStatement ps = session.getSelect(stmt); ps.setString(1, vocabularyElement.toString()); ResultSet rs = null; try { rs = ps.executeQuery(); if (rs.next()) { // the uri already exists return Long.valueOf(rs.getLong("id")); } else { return null; } } finally { if (rs != null) { rs.close(); } } } /** * {@inheritDoc} */ public Long insertVocabularyElement(final CaptureOperationsSession session, final String vocabularyType, final String vocabularyElement) throws SQLException { String tableName = VOCABTYPE_TABLENAME_MAP.get(vocabularyType); String stmt = "INSERT INTO " + tableName + " (uri) VALUES (?)"; if (LOG.isDebugEnabled()) { LOG.debug("INSERT: " + stmt); LOG.debug(" insert param 1: " + vocabularyElement.toString()); } PreparedStatement ps = session.getInsert(stmt); ps.setString(1, vocabularyElement.toString()); ps.executeUpdate(); // get last auto_increment value and return it return getLastAutoIncrementedId(session, tableName); } /** * Retrieves the business transaction with the given type and the given URI * from the database. * * @param session * The database session. * @param bizTrans * The business transaction URI to insert. * @param bizTransType * The type of the business transaction to insert. * @return The ID (primary key) of the matching business transaction, or * <code>null</code> if none was found. * @throws SQLException * If an SQL error occurred. */ private Long getBusinessTransaction(final CaptureOperationsSession session, final String bizTrans, final String bizTransType) throws SQLException { String stmt = "select id from BizTransaction where bizTrans = (select id from voc_BizTrans where uri = ?) and type = (select id from voc_BizTransType where uri = ?);"; PreparedStatement ps = session.getSelect(stmt); ps.setString(1, bizTrans.toString()); ps.setString(2, bizTransType.toString()); ResultSet rs = null; try { rs = ps.executeQuery(); if (rs.next()) { // the BusinessTransaction already exists return Long.valueOf(rs.getLong("id")); } else { return null; } } finally { if (rs != null) { rs.close(); } } } /** * {@inheritDoc} */ public Long insertBusinessTransaction(final CaptureOperationsSession session, final String bizTrans, final String bizTransType) throws SQLException { final Long id = getOrInsertVocabularyElement(session, EpcisConstants.BUSINESS_TRANSACTION_ID, bizTrans); final Long type = getOrInsertVocabularyElement(session, EpcisConstants.BUSINESS_TRANSACTION_TYPE_ID, bizTransType); String stmt = "INSERT INTO BizTransaction (bizTrans, type) VALUES (?, ?)"; if (LOG.isDebugEnabled()) { LOG.debug("INSERT: " + stmt); LOG.debug(" insert param 1: " + bizTrans); LOG.debug(" insert param 2: " + bizTransType); } PreparedStatement ps = session.getInsert(stmt); ps.setLong(1, id.longValue()); ps.setLong(2, type.longValue()); ps.executeUpdate(); return getLastAutoIncrementedId(session, "BizTransaction"); } private Long getOrInsertVocabularyElement(final CaptureOperationsSession session, final String vocabularyType, final String vocabularyElement) throws SQLException { Long vocabularyElementId = getVocabularyElement(session, vocabularyType, vocabularyElement); if (vocabularyElementId != null) { return vocabularyElementId; } else { return insertVocabularyElement(session, vocabularyType, vocabularyElement); } } /** * {@inheritDoc} */ public void insertBusinessTransactionsForEvent(final CaptureOperationsSession session, final long eventId, final String eventType, final List<BusinessTransactionType> btts) throws SQLException { // preparing statement for insertion of associated EPCs List<Long> btIds = new ArrayList<Long>(); for (BusinessTransactionType btt : btts) { btIds.add(getOrInsertBizTransaction(session, btt.getValue(), btt.getType())); } String insert = "INSERT INTO event_" + eventType + "_bizTrans (event_id, bizTrans_id) VALUES (?, ?)"; if (LOG.isDebugEnabled()) { LOG.debug("INSERT: " + insert); } PreparedStatement ps = session.getBatchInsert(insert); // insert all BizTransactions into the BusinessTransaction-Table // and connect it with the "event_<event-name>_bizTrans"-Table for (long btId : btIds) { if (LOG.isDebugEnabled()) { LOG.debug(" insert param 1: " + eventId); LOG.debug(" insert param 2: " + btId); } ps.setLong(1, eventId); ps.setLong(2, btId); ps.addBatch(); } } private Long getOrInsertBizTransaction(final CaptureOperationsSession session, final String bizTrans, final String bizTransType) throws SQLException { Long bizTransactionId = getBusinessTransaction(session, bizTrans, bizTransType); if (bizTransactionId != null) { return bizTransactionId; } else { return insertBusinessTransaction(session, bizTrans, bizTransType); } } /** * {@inheritDoc} */ public void insertExtensionFieldsForEvent(final CaptureOperationsSession session, final long eventId, final String eventType, final List<EventFieldExtension> exts) throws SQLException { for (EventFieldExtension ext : exts) { String insert = "INSERT INTO event_" + eventType + "_extensions " + "(event_id, fieldname, prefix, " + ext.getValueColumnName() + ") VALUES (?, ? ,?, ?)"; PreparedStatement ps = session.getBatchInsert(insert); if (LOG.isDebugEnabled()) { LOG.debug("INSERT: " + insert); LOG.debug(" insert param 1: " + eventId); LOG.debug(" insert param 2: " + ext.getFieldname()); LOG.debug(" insert param 3: " + ext.getPrefix()); LOG.debug(" insert param 4: " + ext.getStrValue()); } ps.setLong(1, eventId); ps.setString(2, ext.getFieldname()); ps.setString(3, ext.getPrefix()); if (ext.getIntValue() != null) { ps.setInt(4, ext.getIntValue().intValue()); } else if (ext.getFloatValue() != null) { ps.setFloat(4, ext.getFloatValue().floatValue()); } else if (ext.getDateValue() != null) { ps.setTimestamp(4, ext.getDateValue()); } else { ps.setString(4, ext.getStrValue()); } ps.addBatch(); } } }