org.hibernate.dialect.function
Class TrimFunctionTemplate

java.lang.Object
  org.hibernate.dialect.function.TrimFunctionTemplate

All Implemented Interfaces:

SQLFunction

Direct Known Subclasses:

AnsiTrimFunction

public abstract class TrimFunctionTemplate
extends Object
implements SQLFunction

Defines the basic template support for TRIM functions

Author:

Steve Ebersole

Nested Class Summary

static class	TrimFunctionTemplate.Options
static class	TrimFunctionTemplate.Specification

Constructor Summary

TrimFunctionTemplate()

Method Summary

Type	getReturnType(Type firstArgument, Mapping mapping) The return type of the function.
boolean	hasArguments() Does this function have any arguments?
boolean	hasParenthesesIfNoArguments() If there are no arguments, are parentheses required?
protected abstract String	render(TrimFunctionTemplate.Options options, String trimSource, SessionFactoryImplementor factory)
String	render(Type firstArgument, List args, SessionFactoryImplementor factory) Render the function call as SQL fragment.

Methods inherited from class java.lang.Object

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

Constructor Detail

TrimFunctionTemplate

public TrimFunctionTemplate()

Method Detail

hasArguments

public boolean hasArguments()

Description copied from interface: SQLFunction

Does this function have any arguments?

Specified by:

hasArguments in interface SQLFunction

Returns:

True if the function expects to have parameters; false otherwise.

hasParenthesesIfNoArguments

public boolean hasParenthesesIfNoArguments()

Description copied from interface: SQLFunction

If there are no arguments, are parentheses required?

Specified by:

hasParenthesesIfNoArguments in interface SQLFunction

Returns:

True if a no-arg call of this function requires parentheses.

getReturnType

public Type getReturnType(Type firstArgument,
                          Mapping mapping)
                   throws QueryException

Description copied from interface: SQLFunction

The return type of the function. May be either a concrete type which is preset, or variable depending upon the type of the first function argument.

Note, the 'firstArgumentType' parameter should match the one passed into SQLFunction.render(org.hibernate.type.Type, java.util.List, org.hibernate.engine.SessionFactoryImplementor)

Specified by:

getReturnType in interface SQLFunction

Parameters:

firstArgument - The type of the first argument

mapping - The mapping source.

Returns:

The type to be expected as a return.

Throws:

QueryException - Indicates an issue resolving the return type.

render

public String render(Type firstArgument,
                     List args,
                     SessionFactoryImplementor factory)
              throws QueryException

Description copied from interface: SQLFunction

Render the function call as SQL fragment.

Note, the 'firstArgumentType' parameter should match the one passed into SQLFunction.getReturnType(org.hibernate.type.Type, org.hibernate.engine.Mapping)

Specified by:

render in interface SQLFunction

Parameters:

firstArgument - The type of the first argument

args - The function arguments

factory - The SessionFactory

Returns:

The rendered function call

Throws:

QueryException - Indicates a problem rendering the function call.

render

protected abstract String render(TrimFunctionTemplate.Options options,
                                 String trimSource,
                                 SessionFactoryImplementor factory)