Package it.unibz.inf.ontop.model.term.functionsymbol.db.impl

Class MySQLDBFunctionSymbolFactory

java.lang.Object

it.unibz.inf.ontop.model.term.functionsymbol.db.impl.AbstractDBFunctionSymbolFactory

it.unibz.inf.ontop.model.term.functionsymbol.db.impl.AbstractSQLDBFunctionSymbolFactory

it.unibz.inf.ontop.model.term.functionsymbol.db.impl.MySQLDBFunctionSymbolFactory

All Implemented Interfaces:

DBFunctionSymbolFactory

public class MySQLDBFunctionSymbolFactory
extends AbstractSQLDBFunctionSymbolFactory

Field Summary

Fields

Modifier and Type	Field	Description
protected static String	CURRENT_TZ_STR
protected static String	UUID_STR

Fields inherited from class it.unibz.inf.ontop.model.term.functionsymbol.db.impl.AbstractSQLDBFunctionSymbolFactory

ABS_STR, abstractRootDBType, abstractRootType, ADD_STR, AND_STR, CEIL_STR, CHAR_LENGTH_STR, COALESCE_STR, CONCAT_OP_STR, CONCAT_STR, CURRENT_TIMESTAMP_STR, dbBooleanType, dbDecimalType, dbDoubleType, dbIntegerType, dbStringType, dbTypeFactory, DIVIDE_STR, FLOOR_STR, LCASE_STR, LENGTH_STR, LOWER_STR, MULTIPLY_STR, NOT_STR, NULLIF_STR, OR_STR, RAND_STR, REGEXP_REPLACE_STR, REPLACE_STR, RIGHT_STR, ROUND_STR, ST_ASTEXT, ST_CONTAINS, ST_CONTAINSPROPERLY, ST_COVEREDBY, ST_COVERS, ST_CROSSES, ST_DISJOINT, ST_DISTANCE, ST_DISTANCE_SPHERE, ST_DISTANCE_SPHEROID, ST_EQUALS, ST_FLIP_COORDINATES, ST_GEOMFROMTEXT, ST_INTERSECTS, ST_MAKEPOINT, ST_OVERLAPS, ST_SETSRID, ST_TOUCHES, ST_TRANSFORM, ST_WITHIN, SUBSTR_STR, SUBSTRING_STR, SUBTRACT_STR, typeFactory, UCASE_STR, UPPER_STR

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	MySQLDBFunctionSymbolFactory(TypeFactory typeFactory)

Method Summary

Modifier and Type	Method	Description
protected DBTypeConversionFunctionSymbol	createDateTimeDenormFunctionSymbol(DBTermType timestampType)	TODO: provide a MySQL specific implementation
protected DBTypeConversionFunctionSymbol	createDateTimeNormFunctionSymbol(DBTermType dbDateTimestampType)
protected DBTypeConversionFunctionSymbol	createDatetimeToDatetimeCastFunctionSymbol(DBTermType inputType, DBTermType targetType)	Made Implicit
protected DBConcatFunctionSymbol	createDBConcatOperator(int arity)
protected DBFunctionSymbol	createDBGroupConcat(DBTermType dbStringType, boolean isDistinct)
protected DBFunctionSymbol	createEncodeURLorIRI(boolean preserveInternationalChars)
protected static it.unibz.inf.ontop.com.google.common.collect.ImmutableTable<String,Integer,DBFunctionSymbol>	createMySQLRegularFunctionTable(TypeFactory typeFactory)
protected it.unibz.inf.ontop.com.google.common.collect.ImmutableTable<DBTermType,RDFDatatype,DBTypeConversionFunctionSymbol>	createNormalizationTable()	We know that the normalization function DATETIME -> xsd:datetimeStamp will always be invalid (it is not bound to any timezone).
protected DBConcatFunctionSymbol	createNullRejectingDBConcat(int arity)	MySQL only supports n-ary CONCAT but not operators like || and +
protected DBConcatFunctionSymbol	createRegularDBConcat(int arity)	CONCAT regular function symbol, not an operator (like || or +)
DBBooleanFunctionSymbol	getDBRegexpMatches2()	NB: For MySQL >= 8, REGEXP_LIKE could be used
DBBooleanFunctionSymbol	getDBRegexpMatches3()
protected String	getUUIDNameInDialect()
protected String	serializeContains(it.unibz.inf.ontop.com.google.common.collect.ImmutableList<? extends ImmutableTerm> terms, Function<ImmutableTerm,String> termConverter, TermFactory termFactory)
protected String	serializeDateTimeNorm(it.unibz.inf.ontop.com.google.common.collect.ImmutableList<? extends ImmutableTerm> terms, Function<ImmutableTerm,String> termConverter, TermFactory termFactory)
protected String	serializeDateTimeNorm(DBTermType dbDateTimestampType, it.unibz.inf.ontop.com.google.common.collect.ImmutableList<? extends ImmutableTerm> terms, Function<ImmutableTerm,String> termConverter)	For DATETIME, never provides a time zone.
protected String	serializeDBRegexpMatches3(it.unibz.inf.ontop.com.google.common.collect.ImmutableList<? extends ImmutableTerm> terms, Function<ImmutableTerm,String> termConverter, TermFactory termFactory)	TODO: throw an exception when the version is detected to be < 8 and reaching the "default" case?
protected String	serializeDBRowNumber(Function<ImmutableTerm,String> converter, TermFactory termFactory)	Only for >= 8.0.2 TODO: provide an alternative implementation for the row unique str for previous versions
protected String	serializeMD5(it.unibz.inf.ontop.com.google.common.collect.ImmutableList<? extends ImmutableTerm> terms, Function<ImmutableTerm,String> termConverter, TermFactory termFactory)
protected String	serializeMillisBetween(it.unibz.inf.ontop.com.google.common.collect.ImmutableList<? extends ImmutableTerm> terms, Function<ImmutableTerm,String> termConverter, TermFactory termFactory)
protected String	serializeSHA1(it.unibz.inf.ontop.com.google.common.collect.ImmutableList<? extends ImmutableTerm> terms, Function<ImmutableTerm,String> termConverter, TermFactory termFactory)
protected String	serializeSHA256(it.unibz.inf.ontop.com.google.common.collect.ImmutableList<? extends ImmutableTerm> terms, Function<ImmutableTerm,String> termConverter, TermFactory termFactory)
protected String	serializeSHA512(it.unibz.inf.ontop.com.google.common.collect.ImmutableList<? extends ImmutableTerm> terms, Function<ImmutableTerm,String> termConverter, TermFactory termFactory)
protected String	serializeStrAfter(it.unibz.inf.ontop.com.google.common.collect.ImmutableList<? extends ImmutableTerm> terms, Function<ImmutableTerm,String> termConverter, TermFactory termFactory)
protected String	serializeStrBefore(it.unibz.inf.ontop.com.google.common.collect.ImmutableList<? extends ImmutableTerm> terms, Function<ImmutableTerm,String> termConverter, TermFactory termFactory)
protected String	serializeTz(it.unibz.inf.ontop.com.google.common.collect.ImmutableList<? extends ImmutableTerm> terms, Function<ImmutableTerm,String> termConverter, TermFactory termFactory)	Tricky as this information may be lost while converting SPARQL constants into DB ones

Methods inherited from class it.unibz.inf.ontop.model.term.functionsymbol.db.impl.AbstractSQLDBFunctionSymbolFactory

createAbsFunctionSymbol, createAddOperator, createBooleanCoalesceFunctionSymbol, createBooleanDenormFunctionSymbol, createBooleanInequality, createBooleanNormFunctionSymbol, createCeilFunctionSymbol, createCoalesceFunctionSymbol, createDateInequality, createDatetimeInequality, createDBAnd, createDBAvg, createDBBooleanCase, createDBCase, createDBCount, createDBIfThenElse, createDBIsNotNull, createDBIsNull, createDBIsTrue, createDBMax, createDBMin, createDBNotFunctionSymbol, createDBOr, createDBStrictEquality, createDBStrictNEquality, createDBSum, createDecimalToDecimalCastFunctionSymbol, createDecimalToStringCastFunctionSymbol, createDefaultCastToStringFunctionSymbol, createDefaultInequality, createDefaultRegularFunctionTable, createDivideOperator, createFloatDoubleToFloatDoubleCastFunctionSymbol, createFloatDoubleToStringCastFunctionSymbol, createFloorFunctionSymbol, createGeometryNormFunctionSymbol, createIntegerToIntegerCastFunctionSymbol, createIntegerToStringCastFunctionSymbol, createIsStringEmpty, createMultiplyOperator, createNonStrictDateEquality, createNonStrictDatetimeEquality, createNonStrictDefaultEquality, createNonStrictNumericEquality, createNonStrictStringEquality, createNumericInequality, createRegularBooleanFunctionSymbol, createRegularUntypedFunctionSymbol, createRoundFunctionSymbol, createSimpleCastFunctionSymbol, createSimpleCastFunctionSymbol, createStringInequality, createStringToStringCastFunctionSymbol, createSubtractOperator, createUntypedAddOperator, createUntypedDivideOperator, createUntypedMultiplyOperator, createUntypedSubtractOperator, getDBAnd, getDBAsText, getDBBoundary, getDBBuffer, getDBCharLength, getDBConcatOperator, getDBConvexHull, getDBDifference, getDBEnvelope, getDBGetSRID, getDBIfThenElse, getDBIntersection, getDBIsNotNull, getDBIsNull, getDBIsStringEmpty, getDBLower, getDBNow, getDBNullIf, getDBOr, getDBRand, getDBRegexpReplace3, getDBRegexpReplace4, getDBRelate, getDBRelateMatrix, getDBReplace, getDBRight, getDBSTContains, getDBSTContainsProperly, getDBSTCoveredBy, getDBSTCovers, getDBSTCrosses, getDBSTDisjoint, getDBSTDistance, getDBSTDistanceSphere, getDBSTDistanceSpheroid, getDBSTEquals, getDBSTFlipCoordinates, getDBSTGeomFromText, getDBSTIntersects, getDBSTMakePoint, getDBSTOverlaps, getDBSTSetSRID, getDBSTTouches, getDBSTTransform, getDBSTWithin, getDBSubString2, getDBSubString3, getDBSymDifference, getDBUnion, getDBUpper, getDBUUID, getIsTrue, getNullRejectingDBConcat, getRandNameInDialect, init, isAnd, isCoalesce, isConcat, isOr, serializeDay, serializeDayFromDate, serializeDayFromDatetime, serializeDaysBetween, serializeDaysBetweenFromDate, serializeDaysBetweenFromDateTime, serializeHours, serializeHoursBetween, serializeMinutes, serializeMinutesBetween, serializeMonth, serializeMonthFromDate, serializeMonthFromDatetime, serializeSeconds, serializeSecondsBetween, serializeWeeksBetween, serializeWeeksBetweenFromDate, serializeWeeksBetweenFromDateTime, serializeYear, serializeYearFromDate, serializeYearFromDatetime

Methods inherited from class it.unibz.inf.ontop.model.term.functionsymbol.db.impl.AbstractDBFunctionSymbolFactory

canonicalizeRegularFunctionSymbolName, createContainsFunctionSymbol, createCurrentDateTimeFunctionSymbol, createDayFromDateFunctionSymbol, createDayFromDatetimeFunctionSymbol, createDaysBetweenFromDateFunctionSymbol, createDaysBetweenFromDateTimeFunctionSymbol, createDBBinaryMathOperator, createDBBooleanIfElseNull, createDBCountTable, createDBIriStringResolver, createDBRowNumber, createDBRowUniqueStr, createDenormalizationTable, createExtractFunctionSymbol, createFalseOrNullFunctionSymbol, createHoursBetweenFromDateTimeFunctionSymbol, createHoursFunctionSymbol, createLikeFunctionSymbol, createMD5FunctionSymbol, createMillisBetweenFromDateTimeFunctionSymbol, createMinutesBetweenFromDateTimeFunctionSymbol, createMinutesFunctionSymbol, createMonthFromDateFunctionSymbol, createMonthFromDatetimeFunctionSymbol, createRegularIfElseNull, createSecondsBetweenFromDateTimeFunctionSymbol, createSecondsFunctionSymbol, createSHA1FunctionSymbol, createSHA256FunctionSymbol, createSHA512FunctionSymbol, createSimilarToFunctionSymbol, createStrAfterFunctionSymbol, createStrBeforeFunctionSymbol, createStrEndsFunctionSymbol, createStrStartsFunctionSymbol, createTrueOrNullFunctionSymbol, createTypeNullFunctionSymbol, createTzFunctionSymbol, createUntypedDBBinaryMathOperator, createWeeksBetweenFromDateFunctionSymbol, createWeeksBetweenFromDateTimeFunctionSymbol, createYearFromDateFunctionSymbol, createYearFromDatetimeFunctionSymbol, getAbs, getBnodeStringTemplateFunctionSymbol, getCeil, getConversion2RDFLexicalFunctionSymbol, getConversionFromRDFLexical2DBFunctionSymbol, getCurrentDateTimeSymbol, getDBBooleanCase, getDBBooleanCoalesce, getDBBooleanIfElseNull, getDBBooleanInequality, getDBCase, getDBCastFunctionSymbol, getDBCastFunctionSymbol, getDBCoalesce, getDBContains, getDBCount, getDBDateInequality, getDBDatetimeInequality, getDBDayFromDate, getDBDayFromDatetime, getDBDaysBetweenFromDate, getDBDaysBetweenFromDateTime, getDBDefaultInequality, getDBEncodeForURI, getDBEndsWith, getDBHours, getDBHoursBetweenFromDateTime, getDBIfElseNull, getDBIntIndex, getDBIriStringResolver, getDBLike, getDBMathBinaryOperator, getDBMax, getDBMd5, getDBMillisBetweenFromDateTime, getDBMin, getDBMinutes, getDBMinutesBetweenFromDateTime, getDBMonthFromDate, getDBMonthFromDatetime, getDBNonStrictDateEquality, getDBNonStrictDatetimeEquality, getDBNonStrictDefaultEquality, getDBNonStrictNumericEquality, getDBNonStrictStringEquality, getDBNot, getDBNumericInequality, getDBRowNumber, getDBRowUniqueStr, getDBSeconds, getDBSecondsBetweenFromDateTime, getDBSha1, getDBSha256, getDBSha512, getDBSimilarTo, getDBStartsWith, getDBStrAfter, getDBStrBefore, getDBStrictEquality, getDBStrictNEquality, getDBStringInequality, getDBSum, getDBTz, getDBWeeksBetweenFromDate, getDBWeeksBetweenFromDateTime, getDBYearFromDate, getDBYearFromDatetime, getExtractFunctionSymbol, getFalseOrNullFunctionSymbol, getFloor, getFreshBnodeStringTemplateFunctionSymbol, getIRIStringTemplateFunctionSymbol, getNullIgnoringDBAvg, getNullIgnoringDBGroupConcat, getNullIgnoringDBSum, getR2RMLIRISafeEncode, getRegularDBBooleanFunctionSymbol, getRegularDBFunctionSymbol, getRound, getTemporaryConversionToDBStringFunctionSymbol, getTrueOrNullFunctionSymbol, getTypedNullFunctionSymbol, getUntypedDBMathBinaryOperator, serializeCurrentDateTime, serializeDBRowUniqueStr, serializeExtract

Methods inherited from class java.lang.Object

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

Field Detail

UUID_STR

protected static final String UUID_STR

See Also:

Constant Field Values

CURRENT_TZ_STR

protected static final String CURRENT_TZ_STR

See Also:

Constant Field Values

Constructor Detail

MySQLDBFunctionSymbolFactory

@Inject
protected MySQLDBFunctionSymbolFactory(TypeFactory typeFactory)

Method Detail

createMySQLRegularFunctionTable

protected static it.unibz.inf.ontop.com.google.common.collect.ImmutableTable<String,Integer,DBFunctionSymbol> createMySQLRegularFunctionTable(TypeFactory typeFactory)

createNormalizationTable

protected it.unibz.inf.ontop.com.google.common.collect.ImmutableTable<DBTermType,RDFDatatype,DBTypeConversionFunctionSymbol> createNormalizationTable()

We know that the normalization function DATETIME -> xsd:datetimeStamp will always be invalid (it is not bound to any timezone). TODO: how to inform the user? In a mapping it would be invalid, but what about a cast in a SPARQL query?

Overrides:

createNormalizationTable in class AbstractDBFunctionSymbolFactory

createDBGroupConcat

protected DBFunctionSymbol createDBGroupConcat(DBTermType dbStringType,
                                               boolean isDistinct)

Overrides:

createDBGroupConcat in class AbstractDBFunctionSymbolFactory

createDateTimeDenormFunctionSymbol

protected DBTypeConversionFunctionSymbol createDateTimeDenormFunctionSymbol(DBTermType timestampType)

TODO: provide a MySQL specific implementation

Overrides:

createDateTimeDenormFunctionSymbol in class AbstractSQLDBFunctionSymbolFactory

serializeContains

protected String serializeContains(it.unibz.inf.ontop.com.google.common.collect.ImmutableList<? extends ImmutableTerm> terms,
                                   Function<ImmutableTerm,String> termConverter,
                                   TermFactory termFactory)

Specified by:

serializeContains in class AbstractDBFunctionSymbolFactory

serializeStrBefore

protected String serializeStrBefore(it.unibz.inf.ontop.com.google.common.collect.ImmutableList<? extends ImmutableTerm> terms,
                                    Function<ImmutableTerm,String> termConverter,
                                    TermFactory termFactory)

Specified by:

serializeStrBefore in class AbstractDBFunctionSymbolFactory

serializeStrAfter

protected String serializeStrAfter(it.unibz.inf.ontop.com.google.common.collect.ImmutableList<? extends ImmutableTerm> terms,
                                   Function<ImmutableTerm,String> termConverter,
                                   TermFactory termFactory)

Specified by:

serializeStrAfter in class AbstractDBFunctionSymbolFactory

serializeMD5

protected String serializeMD5(it.unibz.inf.ontop.com.google.common.collect.ImmutableList<? extends ImmutableTerm> terms,
                              Function<ImmutableTerm,String> termConverter,
                              TermFactory termFactory)

Specified by:

serializeMD5 in class AbstractDBFunctionSymbolFactory

serializeSHA1

protected String serializeSHA1(it.unibz.inf.ontop.com.google.common.collect.ImmutableList<? extends ImmutableTerm> terms,
                               Function<ImmutableTerm,String> termConverter,
                               TermFactory termFactory)

Specified by:

serializeSHA1 in class AbstractDBFunctionSymbolFactory

serializeSHA256

protected String serializeSHA256(it.unibz.inf.ontop.com.google.common.collect.ImmutableList<? extends ImmutableTerm> terms,
                                 Function<ImmutableTerm,String> termConverter,
                                 TermFactory termFactory)

Specified by:

serializeSHA256 in class AbstractDBFunctionSymbolFactory

serializeSHA512

protected String serializeSHA512(it.unibz.inf.ontop.com.google.common.collect.ImmutableList<? extends ImmutableTerm> terms,
                                 Function<ImmutableTerm,String> termConverter,
                                 TermFactory termFactory)

Specified by:

serializeSHA512 in class AbstractDBFunctionSymbolFactory

serializeTz

protected String serializeTz(it.unibz.inf.ontop.com.google.common.collect.ImmutableList<? extends ImmutableTerm> terms,
                             Function<ImmutableTerm,String> termConverter,
                             TermFactory termFactory)

Tricky as this information may be lost while converting SPARQL constants into DB ones

Specified by:

serializeTz in class AbstractDBFunctionSymbolFactory

serializeDBRowNumber

protected String serializeDBRowNumber(Function<ImmutableTerm,String> converter,
                                      TermFactory termFactory)

Only for >= 8.0.2 TODO: provide an alternative implementation for the row unique str for previous versions

Overrides:

serializeDBRowNumber in class AbstractSQLDBFunctionSymbolFactory

createDateTimeNormFunctionSymbol

protected DBTypeConversionFunctionSymbol createDateTimeNormFunctionSymbol(DBTermType dbDateTimestampType)

Overrides:

createDateTimeNormFunctionSymbol in class AbstractSQLDBFunctionSymbolFactory

serializeDateTimeNorm

protected String serializeDateTimeNorm(DBTermType dbDateTimestampType,
                                       it.unibz.inf.ontop.com.google.common.collect.ImmutableList<? extends ImmutableTerm> terms,
                                       Function<ImmutableTerm,String> termConverter)

For DATETIME, never provides a time zone. For TIMESTAMP, provides the session time zone used for generating the string (NB: TIMESTAMP is stored as a duration from a fixed date time)

serializeDateTimeNorm

protected String serializeDateTimeNorm(it.unibz.inf.ontop.com.google.common.collect.ImmutableList<? extends ImmutableTerm> terms,
                                       Function<ImmutableTerm,String> termConverter,
                                       TermFactory termFactory)

Specified by:

serializeDateTimeNorm in class AbstractSQLDBFunctionSymbolFactory

createNullRejectingDBConcat

protected DBConcatFunctionSymbol createNullRejectingDBConcat(int arity)

MySQL only supports n-ary CONCAT but not operators like || and +

Specified by:

createNullRejectingDBConcat in class AbstractSQLDBFunctionSymbolFactory

createDBConcatOperator

protected DBConcatFunctionSymbol createDBConcatOperator(int arity)

Specified by:

createDBConcatOperator in class AbstractSQLDBFunctionSymbolFactory

createRegularDBConcat

protected DBConcatFunctionSymbol createRegularDBConcat(int arity)

Description copied from class: AbstractSQLDBFunctionSymbolFactory

CONCAT regular function symbol, not an operator (like || or +)

Specified by:

createRegularDBConcat in class AbstractSQLDBFunctionSymbolFactory

createDatetimeToDatetimeCastFunctionSymbol

protected DBTypeConversionFunctionSymbol createDatetimeToDatetimeCastFunctionSymbol(DBTermType inputType,
                                                                                    DBTermType targetType)

Made Implicit

Overrides:

createDatetimeToDatetimeCastFunctionSymbol in class AbstractSQLDBFunctionSymbolFactory

createEncodeURLorIRI

protected DBFunctionSymbol createEncodeURLorIRI(boolean preserveInternationalChars)

Overrides:

createEncodeURLorIRI in class AbstractSQLDBFunctionSymbolFactory

getUUIDNameInDialect

protected String getUUIDNameInDialect()

Specified by:

getUUIDNameInDialect in class AbstractSQLDBFunctionSymbolFactory

getDBRegexpMatches2

public DBBooleanFunctionSymbol getDBRegexpMatches2()

NB: For MySQL >= 8, REGEXP_LIKE could be used

Specified by:

getDBRegexpMatches2 in interface DBFunctionSymbolFactory

Overrides:

getDBRegexpMatches2 in class AbstractSQLDBFunctionSymbolFactory

getDBRegexpMatches3

public DBBooleanFunctionSymbol getDBRegexpMatches3()

Specified by:

getDBRegexpMatches3 in interface DBFunctionSymbolFactory

Overrides:

getDBRegexpMatches3 in class AbstractSQLDBFunctionSymbolFactory

serializeDBRegexpMatches3

protected String serializeDBRegexpMatches3(it.unibz.inf.ontop.com.google.common.collect.ImmutableList<? extends ImmutableTerm> terms,
                                           Function<ImmutableTerm,String> termConverter,
                                           TermFactory termFactory)

TODO: throw an exception when the version is detected to be < 8 and reaching the "default" case?

serializeMillisBetween

protected String serializeMillisBetween(it.unibz.inf.ontop.com.google.common.collect.ImmutableList<? extends ImmutableTerm> terms,
                                        Function<ImmutableTerm,String> termConverter,
                                        TermFactory termFactory)

Overrides:

serializeMillisBetween in class AbstractSQLDBFunctionSymbolFactory