RenderContext (jOOQ 3.7.0 API)

All Superinterfaces:

Context<RenderContext>, Scope
```
public interface RenderContext
extends Context<RenderContext>
```
The render context is used for rendering QueryPart's to SQL.
A new render context is instantiated every time a Query is rendered. QueryPart's will then pass the same context to their components

Author:

Lukas Eder

See Also:

BindContext

Nested Class Summary

Nested Classes
Modifier and Type Interface and Description

static class RenderContext.CastMode
The cast mode for bind values.

Nested Classes
Modifier and Type	Interface and Description
`static class`	`RenderContext.CastMode` The cast mode for bind values.

Method Summary

All Methods Instance Methods Abstract Methods Deprecated Methods
Modifier and Type	Method and Description
`Boolean`	`cast()` Deprecated. - [#3703] - 3.5.0 - Do not use this any longer
`RenderContext.CastMode`	`castMode()` The currently applied cast mode for bind values.
`RenderContext`	`castMode(RenderContext.CastMode mode)` Set the new cast mode for `castMode()`.
`RenderContext`	`castModeSome(SQLDialect... dialects)` Deprecated. - [#3703] - 3.5.0 - Do not use this any longer
`boolean`	`format()` The value of `Settings.isRenderFormatted()`.
`RenderContext`	`format(boolean format)` Override the value of `Settings.isRenderFormatted()`.
`RenderContext`	`formatIndentEnd()` Stop indenting subsequent SQL by one level (two characters), if `Settings.isRenderFormatted()` is set to `true`.
`RenderContext`	`formatIndentEnd(int indent)` Stop indenting subsequent SQL by a number of characters, if `Settings.isRenderFormatted()` is set to `true`.
`RenderContext`	`formatIndentLockEnd()` Stop indenting subsequent SQL at the same level as the current line, if `Settings.isRenderFormatted()` is set to `true`.
`RenderContext`	`formatIndentLockStart()` Start indenting subsequent SQL at the same level as the current line, if `Settings.isRenderFormatted()` is set to `true`.
`RenderContext`	`formatIndentStart()` Start indenting subsequent SQL by one level (two characters), if `Settings.isRenderFormatted()` is set to `true`.
`RenderContext`	`formatIndentStart(int indent)` Start indenting subsequent SQL by a number of characters, if `Settings.isRenderFormatted()` is set to `true`.
`RenderContext`	`formatNewLine()` Render a new line character (only if `Settings.isRenderFormatted()` is set to `true`).
`RenderContext`	`formatNewLineAfterPrintMargin()` Render a new line character (only if `Settings.isRenderFormatted()` is set to `true`, and the `formatPrintMargin(int)` has been exceeded).
`RenderContext`	`formatPrintMargin(int margin)` Set a print margin that will be applied to formatted SQL, if `Settings.isRenderFormatted()` is set to `true`.
`RenderContext`	`formatSeparator()` Render a new line character (only if `Settings.isRenderFormatted()` is set to `true`), or a whitespace separator character otherwise.
`boolean`	`inline()` Deprecated. - 3.1.0 - [#2414] - This method should no longer be used. Use `paramType()` instead.
`RenderContext`	`inline(boolean inline)` Deprecated. - 3.1.0 - [#2414] - This method should no longer be used. Use `paramType(ParamType)` instead.
`RenderContext`	`keyword(String keyword)` Append a SQL keyword to the context's contained `StringBuilder`.
`RenderContext`	`literal(String literal)` Append some (quoted) literal to the context's contained `StringBuilder`.
`boolean`	`namedParams()` Deprecated. - 3.1.0 - [#2414] - This method should no longer be used. Use `paramType()` instead.
`RenderContext`	`namedParams(boolean renderNamedParams)` Deprecated. - 3.1.0 - [#2414] - This method should no longer be used. Use `paramType(ParamType)` instead.
`String`	`nextAlias()` Return a new alias that is unique for the scope of one query.
`ParamType`	`paramType()` Specify, how bind values should be rendered.
`RenderContext`	`paramType(ParamType paramType)` Set the new context value for `paramType()`.
`String`	`peekAlias()` Peek the next alias that will be generated by `nextAlias()`.
`boolean`	`qualify()` Whether query parts should render qualified names or not.
`RenderContext`	`qualify(boolean qualify)` Sett the new context value for `qualify()`.
`String`	`render()` Render the context's underlying SQL statement.
`String`	`render(QueryPart part)` Render a query part in a new context derived from this one.
`RenderContext`	`sql(char sql)` Append some SQL to the context's contained `StringBuilder`.
`RenderContext`	`sql(int sql)` Append some SQL to the context's contained `StringBuilder`.
`RenderContext`	`sql(QueryPart part)` Deprecated. - 3.2.0 - [#2666] - Use `Context.visit(QueryPart)` instead
`RenderContext`	`sql(String sql)` Append some SQL to the context's contained `StringBuilder`.
`RenderContext`	`sql(String sql, boolean literal)` Append some SQL to the context's contained `StringBuilder`.

Methods inherited from interface org.jooq.Context
bindValue, declareCTE, declareCTE, declareFields, declareFields, declareTables, declareTables, declareWindows, declareWindows, end, nextIndex, peekIndex, start, statement, subquery, subquery, visit

Methods inherited from interface org.jooq.Scope
configuration, data, data, data, dialect, family, settings

- Method Detail
  - peekAlias
```
String peekAlias()
```
    Peek the next alias that will be generated by nextAlias().
    
    Specified by:
    
    peekAlias in interface Context<RenderContext>
  - nextAlias
```
String nextAlias()
```
    Return a new alias that is unique for the scope of one query. These aliases are sometimes needed when unaliased projections are defined in subqueries, which can lead to syntax errors.
    
    Specified by:
    
    nextAlias in interface Context<RenderContext>
  - render
```
String render()
```
    Render the context's underlying SQL statement.
    
    Specified by:
    
    render in interface Context<RenderContext>
  - render
```
String render(QueryPart part)
```
    Render a query part in a new context derived from this one. The rendered SQL will not be appended to this context.
    
    Specified by:
    
    render in interface Context<RenderContext>
  - keyword
```
RenderContext keyword(String keyword)
```
    Append a SQL keyword to the context's contained StringBuilder.
    Use this to have your SQL keyword rendered in RenderKeywordStyle.
    
    Specified by:
    
    keyword in interface Context<RenderContext>
  - sql
```
RenderContext sql(String sql)
```
    Append some SQL to the context's contained StringBuilder.
    
    Specified by:
    
    sql in interface Context<RenderContext>
  - sql
```
RenderContext sql(String sql,
                  boolean literal)
```
    Append some SQL to the context's contained StringBuilder.
    Set literal = true to indicate that the RenderContext shall not format the argument SQL.
    
    Specified by:
    
    sql in interface Context<RenderContext>
  - sql
```
RenderContext sql(char sql)
```
    Append some SQL to the context's contained StringBuilder.
    
    Specified by:
    
    sql in interface Context<RenderContext>
  - sql
```
RenderContext sql(int sql)
```
    Append some SQL to the context's contained StringBuilder.
    
    Specified by:
    
    sql in interface Context<RenderContext>
  - sql
```
@Deprecated
RenderContext sql(QueryPart part)
```
    Deprecated. - 3.2.0 - [#2666] - Use Context.visit(QueryPart) instead
    
    Recurse rendering.
  - format
```
RenderContext format(boolean format)
```
    Override the value of Settings.isRenderFormatted().
    
    Specified by:
    
    format in interface Context<RenderContext>
  - format
```
boolean format()
```
    The value of Settings.isRenderFormatted().
    
    Specified by:
    
    format in interface Context<RenderContext>
  - formatNewLine
```
RenderContext formatNewLine()
```
    Render a new line character (only if Settings.isRenderFormatted() is set to true).
    
    Specified by:
    
    formatNewLine in interface Context<RenderContext>
  - formatNewLineAfterPrintMargin
```
RenderContext formatNewLineAfterPrintMargin()
```
    Render a new line character (only if Settings.isRenderFormatted() is set to true, and the formatPrintMargin(int) has been exceeded).
    
    Specified by:
    
    formatNewLineAfterPrintMargin in interface Context<RenderContext>
  - formatSeparator
```
RenderContext formatSeparator()
```
    Render a new line character (only if Settings.isRenderFormatted() is set to true), or a whitespace separator character otherwise.
    
    Specified by:
    
    formatSeparator in interface Context<RenderContext>
  - formatIndentStart
```
RenderContext formatIndentStart()
```
    Start indenting subsequent SQL by one level (two characters), if Settings.isRenderFormatted() is set to true.
    This is the same as calling formatIndentStart(int) with a parameter of 2
    
    Specified by:
    
    formatIndentStart in interface Context<RenderContext>
  - formatIndentStart
```
RenderContext formatIndentStart(int indent)
```
    Start indenting subsequent SQL by a number of characters, if Settings.isRenderFormatted() is set to true.
    
    Specified by:
    
    formatIndentStart in interface Context<RenderContext>
  - formatIndentLockStart
```
RenderContext formatIndentLockStart()
```
    Start indenting subsequent SQL at the same level as the current line, if Settings.isRenderFormatted() is set to true.
    
    Specified by:
    
    formatIndentLockStart in interface Context<RenderContext>
  - formatIndentEnd
```
RenderContext formatIndentEnd()
```
    Stop indenting subsequent SQL by one level (two characters), if Settings.isRenderFormatted() is set to true.
    This is the same as calling formatIndentEnd(int) with a parameter of 2
    
    Specified by:
    
    formatIndentEnd in interface Context<RenderContext>
  - formatIndentEnd
```
RenderContext formatIndentEnd(int indent)
```
    Stop indenting subsequent SQL by a number of characters, if Settings.isRenderFormatted() is set to true.
    
    Specified by:
    
    formatIndentEnd in interface Context<RenderContext>
  - formatIndentLockEnd
```
RenderContext formatIndentLockEnd()
```
    Stop indenting subsequent SQL at the same level as the current line, if Settings.isRenderFormatted() is set to true.
    
    Specified by:
    
    formatIndentLockEnd in interface Context<RenderContext>
  - formatPrintMargin
```
RenderContext formatPrintMargin(int margin)
```
    Set a print margin that will be applied to formatted SQL, if Settings.isRenderFormatted() is set to true.
    The default print margin is 80. Setting this to zero or a negative value means that no print margin will be applied.
    The print margin is applied to any of these QueryParts:
    - Field.in(Field...) and related expressions
    Specified by:
    
    formatPrintMargin in interface Context<RenderContext>
  - literal
```
RenderContext literal(String literal)
```
    Append some (quoted) literal to the context's contained StringBuilder.
    
    Specified by:
    
    literal in interface Context<RenderContext>
  - inline
```
@Deprecated
boolean inline()
```
    Deprecated. - 3.1.0 - [#2414] - This method should no longer be used. Use paramType() instead.
    
    Whether bind variables should be inlined, rather than rendered as '?'.
  - inline
```
@Deprecated
RenderContext inline(boolean inline)
```
    Deprecated. - 3.1.0 - [#2414] - This method should no longer be used. Use paramType(ParamType) instead.
    
    Set the new context value for inline().
  - qualify
```
boolean qualify()
```
    Whether query parts should render qualified names or not.
    
    Specified by:
    
    qualify in interface Context<RenderContext>
  - qualify
```
RenderContext qualify(boolean qualify)
```
    Sett the new context value for qualify().
    
    Specified by:
    
    qualify in interface Context<RenderContext>
  - namedParams
```
@Deprecated
boolean namedParams()
```
    Deprecated. - 3.1.0 - [#2414] - This method should no longer be used. Use paramType() instead.
    
    Whether bind variables should be rendered as named parameters:
    :1, :2, :custom_name
    or as JDBC bind variables
    ?
  - namedParams
```
@Deprecated
RenderContext namedParams(boolean renderNamedParams)
```
    Deprecated. - 3.1.0 - [#2414] - This method should no longer be used. Use paramType(ParamType) instead.
    
    Set the new context value for namedParams().
  - paramType
```
ParamType paramType()
```
    Specify, how bind values should be rendered.
    - As ParamType.INDEXED parameters:
      ?, ?, ?
    - As ParamType.NAMED parameters:
      :1, :2, :custom_name
    - As ParamType.INLINED parameters:
      1, 'A', null
    Specified by:
    
    paramType in interface Context<RenderContext>
  - paramType
```
RenderContext paramType(ParamType paramType)
```
    Set the new context value for paramType().
    
    Specified by:
    
    paramType in interface Context<RenderContext>
  - castMode
```
RenderContext.CastMode castMode()
```
    The currently applied cast mode for bind values.
    
    Specified by:
    
    castMode in interface Context<RenderContext>
  - castMode
```
RenderContext castMode(RenderContext.CastMode mode)
```
    Set the new cast mode for castMode().
    
    Specified by:
    
    castMode in interface Context<RenderContext>
  - cast
```
@Deprecated
Boolean cast()
```
    Deprecated. - [#3703] - 3.5.0 - Do not use this any longer
    
    Whether casting must be applied. The result follows this logic:
    
    CastMode result
    
    ALWAYS true
    
    NEVER false
    
    SOME true or false depending on the dialect
    
    DEFAULT null
    
    Specified by:
    
    cast in interface Context<RenderContext>
  - castModeSome
```
@Deprecated
RenderContext castModeSome(SQLDialect... dialects)
```
    Deprecated. - [#3703] - 3.5.0 - Do not use this any longer
    
    Set the new cast mode to RenderContext.CastMode.SOME for a list of dialects.
    
    Specified by:
    
    castModeSome in interface Context<RenderContext>

CastMode	result
`ALWAYS`	`true`
`NEVER`	`false`
`SOME`	`true` or `false` depending on the dialect
`DEFAULT`	`null`

Interface RenderContext

Nested Class Summary

Method Summary

Methods inherited from interface org.jooq.Context

Methods inherited from interface org.jooq.Scope

Method Detail

peekAlias

nextAlias

render

render

keyword

sql

sql

sql

sql

sql

format

format

formatNewLine

formatNewLineAfterPrintMargin

formatSeparator

formatIndentStart

formatIndentStart

formatIndentLockStart

formatIndentEnd

formatIndentEnd

formatIndentLockEnd

formatPrintMargin

literal

inline

inline

qualify

qualify

namedParams

namedParams

paramType

paramType

castMode

castMode

cast

castModeSome