Interface TwitterSearchEndpointBuilderFactory.TwitterSearchEndpointConsumerBuilder
- All Superinterfaces:
org.apache.camel.builder.EndpointConsumerBuilder,org.apache.camel.EndpointConsumerResolver
- All Known Subinterfaces:
TwitterSearchEndpointBuilderFactory.TwitterSearchEndpointBuilder
- Enclosing interface:
TwitterSearchEndpointBuilderFactory
public static interface TwitterSearchEndpointBuilderFactory.TwitterSearchEndpointConsumerBuilder
extends org.apache.camel.builder.EndpointConsumerBuilder
Builder for endpoint consumers for the Twitter Search component.
-
Method Summary
Modifier and TypeMethodDescriptionaccessToken(String accessToken) The access token.accessTokenSecret(String accessTokenSecret) The access secret.advanced()backoffErrorThreshold(int backoffErrorThreshold) The number of subsequent error polls (failed due some error) that should happen before the backoffMultipler should kick-in.backoffErrorThreshold(String backoffErrorThreshold) The number of subsequent error polls (failed due some error) that should happen before the backoffMultipler should kick-in.backoffIdleThreshold(int backoffIdleThreshold) The number of subsequent idle polls that should happen before the backoffMultipler should kick-in.backoffIdleThreshold(String backoffIdleThreshold) The number of subsequent idle polls that should happen before the backoffMultipler should kick-in.backoffMultiplier(int backoffMultiplier) To let the scheduled polling consumer backoff if there has been a number of subsequent idles/errors in a row.backoffMultiplier(String backoffMultiplier) To let the scheduled polling consumer backoff if there has been a number of subsequent idles/errors in a row.consumerKey(String consumerKey) The consumer key.consumerSecret(String consumerSecret) The consumer secret.Limiting number of results per page.Limiting number of results per page.delay(long delay) Milliseconds before the next poll.Milliseconds before the next poll.filterOld(boolean filterOld) Filter out old tweets, that has previously been polled.Filter out old tweets, that has previously been polled.greedy(boolean greedy) If greedy is enabled, then the ScheduledPollConsumer will run immediately again, if the previous run polled 1 or more messages.If greedy is enabled, then the ScheduledPollConsumer will run immediately again, if the previous run polled 1 or more messages.httpProxyHost(String httpProxyHost) The http proxy host which can be used for the camel-twitter.httpProxyPassword(String httpProxyPassword) The http proxy password which can be used for the camel-twitter.httpProxyPort(Integer httpProxyPort) The http proxy port which can be used for the camel-twitter.httpProxyPort(String httpProxyPort) The http proxy port which can be used for the camel-twitter.httpProxyUser(String httpProxyUser) The http proxy user which can be used for the camel-twitter.initialDelay(long initialDelay) Milliseconds before the first poll starts.initialDelay(String initialDelay) Milliseconds before the first poll starts.The lang string ISO_639-1 which will be used for searching.numberOfPages(Integer numberOfPages) The number of pages result which you want camel-twitter to consume.numberOfPages(String numberOfPages) The number of pages result which you want camel-twitter to consume.repeatCount(long repeatCount) Specifies a maximum limit of number of fires.repeatCount(String repeatCount) Specifies a maximum limit of number of fires.runLoggingLevel(String runLoggingLevel) The consumer logs a start/complete log line when it polls.runLoggingLevel(org.apache.camel.LoggingLevel runLoggingLevel) The consumer logs a start/complete log line when it polls.scheduledExecutorService(String scheduledExecutorService) Allows for configuring a custom/shared thread pool to use for the consumer.scheduledExecutorService(ScheduledExecutorService scheduledExecutorService) Allows for configuring a custom/shared thread pool to use for the consumer.To use a cron scheduler from either camel-spring or camel-quartz component.To use a cron scheduler from either camel-spring or camel-quartz component.schedulerProperties(String key, Object value) To configure additional properties when using a custom scheduler or any of the Quartz, Spring based scheduler.schedulerProperties(Map values) To configure additional properties when using a custom scheduler or any of the Quartz, Spring based scheduler.sendEmptyMessageWhenIdle(boolean sendEmptyMessageWhenIdle) If the polling consumer did not poll any files, you can enable this option to send an empty message (no body) instead.sendEmptyMessageWhenIdle(String sendEmptyMessageWhenIdle) If the polling consumer did not poll any files, you can enable this option to send an empty message (no body) instead.sinceId(long sinceId) The last tweet id which will be used for pulling the tweets.The last tweet id which will be used for pulling the tweets.sortById(boolean sortById) Sorts by id, so the oldest are first, and newest last.Sorts by id, so the oldest are first, and newest last.startScheduler(boolean startScheduler) Whether the scheduler should be auto started.startScheduler(String startScheduler) Whether the scheduler should be auto started.Time unit for initialDelay and delay options.Time unit for initialDelay and delay options.Endpoint type to use.type(org.apache.camel.component.twitter.data.EndpointType type) Endpoint type to use.useFixedDelay(boolean useFixedDelay) Controls if fixed delay or fixed rate is used.useFixedDelay(String useFixedDelay) Controls if fixed delay or fixed rate is used.To filter by user ids for filter.Methods inherited from interface org.apache.camel.builder.EndpointConsumerBuilder
doSetMultiValueProperties, doSetMultiValueProperty, doSetProperty, expr, getRawUri, getUriMethods inherited from interface org.apache.camel.EndpointConsumerResolver
resolve, resolve
-
Method Details
-
advanced
-
sendEmptyMessageWhenIdle
default TwitterSearchEndpointBuilderFactory.TwitterSearchEndpointConsumerBuilder sendEmptyMessageWhenIdle(boolean sendEmptyMessageWhenIdle) If the polling consumer did not poll any files, you can enable this option to send an empty message (no body) instead. The option is a:booleantype. Default: false Group: consumer- Parameters:
sendEmptyMessageWhenIdle- the value to set- Returns:
- the dsl builder
-
sendEmptyMessageWhenIdle
default TwitterSearchEndpointBuilderFactory.TwitterSearchEndpointConsumerBuilder sendEmptyMessageWhenIdle(String sendEmptyMessageWhenIdle) If the polling consumer did not poll any files, you can enable this option to send an empty message (no body) instead. The option will be converted to abooleantype. Default: false Group: consumer- Parameters:
sendEmptyMessageWhenIdle- the value to set- Returns:
- the dsl builder
-
type
default TwitterSearchEndpointBuilderFactory.TwitterSearchEndpointConsumerBuilder type(org.apache.camel.component.twitter.data.EndpointType type) Endpoint type to use. The option is a:org.apache.camel.component.twitter.data.EndpointTypetype. Default: polling Group: consumer- Parameters:
type- the value to set- Returns:
- the dsl builder
-
type
Endpoint type to use. The option will be converted to aorg.apache.camel.component.twitter.data.EndpointTypetype. Default: polling Group: consumer- Parameters:
type- the value to set- Returns:
- the dsl builder
-
count
default TwitterSearchEndpointBuilderFactory.TwitterSearchEndpointConsumerBuilder count(Integer count) Limiting number of results per page. The option is a:java.lang.Integertype. Default: 5 Group: filter- Parameters:
count- the value to set- Returns:
- the dsl builder
-
count
default TwitterSearchEndpointBuilderFactory.TwitterSearchEndpointConsumerBuilder count(String count) Limiting number of results per page. The option will be converted to ajava.lang.Integertype. Default: 5 Group: filter- Parameters:
count- the value to set- Returns:
- the dsl builder
-
filterOld
default TwitterSearchEndpointBuilderFactory.TwitterSearchEndpointConsumerBuilder filterOld(boolean filterOld) Filter out old tweets, that has previously been polled. This state is stored in memory only, and based on last tweet id. The option is a:booleantype. Default: true Group: filter- Parameters:
filterOld- the value to set- Returns:
- the dsl builder
-
filterOld
default TwitterSearchEndpointBuilderFactory.TwitterSearchEndpointConsumerBuilder filterOld(String filterOld) Filter out old tweets, that has previously been polled. This state is stored in memory only, and based on last tweet id. The option will be converted to abooleantype. Default: true Group: filter- Parameters:
filterOld- the value to set- Returns:
- the dsl builder
-
lang
The lang string ISO_639-1 which will be used for searching. The option is a:java.lang.Stringtype. Group: filter- Parameters:
lang- the value to set- Returns:
- the dsl builder
-
numberOfPages
default TwitterSearchEndpointBuilderFactory.TwitterSearchEndpointConsumerBuilder numberOfPages(Integer numberOfPages) The number of pages result which you want camel-twitter to consume. The option is a:java.lang.Integertype. Default: 1 Group: filter- Parameters:
numberOfPages- the value to set- Returns:
- the dsl builder
-
numberOfPages
default TwitterSearchEndpointBuilderFactory.TwitterSearchEndpointConsumerBuilder numberOfPages(String numberOfPages) The number of pages result which you want camel-twitter to consume. The option will be converted to ajava.lang.Integertype. Default: 1 Group: filter- Parameters:
numberOfPages- the value to set- Returns:
- the dsl builder
-
sinceId
default TwitterSearchEndpointBuilderFactory.TwitterSearchEndpointConsumerBuilder sinceId(long sinceId) The last tweet id which will be used for pulling the tweets. It is useful when the camel route is restarted after a long running. The option is a:longtype. Default: 1 Group: filter- Parameters:
sinceId- the value to set- Returns:
- the dsl builder
-
sinceId
default TwitterSearchEndpointBuilderFactory.TwitterSearchEndpointConsumerBuilder sinceId(String sinceId) The last tweet id which will be used for pulling the tweets. It is useful when the camel route is restarted after a long running. The option will be converted to alongtype. Default: 1 Group: filter- Parameters:
sinceId- the value to set- Returns:
- the dsl builder
-
userIds
default TwitterSearchEndpointBuilderFactory.TwitterSearchEndpointConsumerBuilder userIds(String userIds) To filter by user ids for filter. Multiple values can be separated by comma. The option is a:java.lang.Stringtype. Group: filter- Parameters:
userIds- the value to set- Returns:
- the dsl builder
-
httpProxyHost
default TwitterSearchEndpointBuilderFactory.TwitterSearchEndpointConsumerBuilder httpProxyHost(String httpProxyHost) The http proxy host which can be used for the camel-twitter. Can also be configured on the TwitterComponent level instead. The option is a:java.lang.Stringtype. Group: proxy- Parameters:
httpProxyHost- the value to set- Returns:
- the dsl builder
-
httpProxyPassword
default TwitterSearchEndpointBuilderFactory.TwitterSearchEndpointConsumerBuilder httpProxyPassword(String httpProxyPassword) The http proxy password which can be used for the camel-twitter. Can also be configured on the TwitterComponent level instead. The option is a:java.lang.Stringtype. Group: proxy- Parameters:
httpProxyPassword- the value to set- Returns:
- the dsl builder
-
httpProxyPort
default TwitterSearchEndpointBuilderFactory.TwitterSearchEndpointConsumerBuilder httpProxyPort(Integer httpProxyPort) The http proxy port which can be used for the camel-twitter. Can also be configured on the TwitterComponent level instead. The option is a:java.lang.Integertype. Group: proxy- Parameters:
httpProxyPort- the value to set- Returns:
- the dsl builder
-
httpProxyPort
default TwitterSearchEndpointBuilderFactory.TwitterSearchEndpointConsumerBuilder httpProxyPort(String httpProxyPort) The http proxy port which can be used for the camel-twitter. Can also be configured on the TwitterComponent level instead. The option will be converted to ajava.lang.Integertype. Group: proxy- Parameters:
httpProxyPort- the value to set- Returns:
- the dsl builder
-
httpProxyUser
default TwitterSearchEndpointBuilderFactory.TwitterSearchEndpointConsumerBuilder httpProxyUser(String httpProxyUser) The http proxy user which can be used for the camel-twitter. Can also be configured on the TwitterComponent level instead. The option is a:java.lang.Stringtype. Group: proxy- Parameters:
httpProxyUser- the value to set- Returns:
- the dsl builder
-
backoffErrorThreshold
default TwitterSearchEndpointBuilderFactory.TwitterSearchEndpointConsumerBuilder backoffErrorThreshold(int backoffErrorThreshold) The number of subsequent error polls (failed due some error) that should happen before the backoffMultipler should kick-in. The option is a:inttype. Group: scheduler- Parameters:
backoffErrorThreshold- the value to set- Returns:
- the dsl builder
-
backoffErrorThreshold
default TwitterSearchEndpointBuilderFactory.TwitterSearchEndpointConsumerBuilder backoffErrorThreshold(String backoffErrorThreshold) The number of subsequent error polls (failed due some error) that should happen before the backoffMultipler should kick-in. The option will be converted to ainttype. Group: scheduler- Parameters:
backoffErrorThreshold- the value to set- Returns:
- the dsl builder
-
backoffIdleThreshold
default TwitterSearchEndpointBuilderFactory.TwitterSearchEndpointConsumerBuilder backoffIdleThreshold(int backoffIdleThreshold) The number of subsequent idle polls that should happen before the backoffMultipler should kick-in. The option is a:inttype. Group: scheduler- Parameters:
backoffIdleThreshold- the value to set- Returns:
- the dsl builder
-
backoffIdleThreshold
default TwitterSearchEndpointBuilderFactory.TwitterSearchEndpointConsumerBuilder backoffIdleThreshold(String backoffIdleThreshold) The number of subsequent idle polls that should happen before the backoffMultipler should kick-in. The option will be converted to ainttype. Group: scheduler- Parameters:
backoffIdleThreshold- the value to set- Returns:
- the dsl builder
-
backoffMultiplier
default TwitterSearchEndpointBuilderFactory.TwitterSearchEndpointConsumerBuilder backoffMultiplier(int backoffMultiplier) To let the scheduled polling consumer backoff if there has been a number of subsequent idles/errors in a row. The multiplier is then the number of polls that will be skipped before the next actual attempt is happening again. When this option is in use then backoffIdleThreshold and/or backoffErrorThreshold must also be configured. The option is a:inttype. Group: scheduler- Parameters:
backoffMultiplier- the value to set- Returns:
- the dsl builder
-
backoffMultiplier
default TwitterSearchEndpointBuilderFactory.TwitterSearchEndpointConsumerBuilder backoffMultiplier(String backoffMultiplier) To let the scheduled polling consumer backoff if there has been a number of subsequent idles/errors in a row. The multiplier is then the number of polls that will be skipped before the next actual attempt is happening again. When this option is in use then backoffIdleThreshold and/or backoffErrorThreshold must also be configured. The option will be converted to ainttype. Group: scheduler- Parameters:
backoffMultiplier- the value to set- Returns:
- the dsl builder
-
delay
Milliseconds before the next poll. The option is a:longtype. Default: 30000 Group: scheduler- Parameters:
delay- the value to set- Returns:
- the dsl builder
-
delay
default TwitterSearchEndpointBuilderFactory.TwitterSearchEndpointConsumerBuilder delay(String delay) Milliseconds before the next poll. The option will be converted to alongtype. Default: 30000 Group: scheduler- Parameters:
delay- the value to set- Returns:
- the dsl builder
-
greedy
default TwitterSearchEndpointBuilderFactory.TwitterSearchEndpointConsumerBuilder greedy(boolean greedy) If greedy is enabled, then the ScheduledPollConsumer will run immediately again, if the previous run polled 1 or more messages. The option is a:booleantype. Default: false Group: scheduler- Parameters:
greedy- the value to set- Returns:
- the dsl builder
-
greedy
default TwitterSearchEndpointBuilderFactory.TwitterSearchEndpointConsumerBuilder greedy(String greedy) If greedy is enabled, then the ScheduledPollConsumer will run immediately again, if the previous run polled 1 or more messages. The option will be converted to abooleantype. Default: false Group: scheduler- Parameters:
greedy- the value to set- Returns:
- the dsl builder
-
initialDelay
default TwitterSearchEndpointBuilderFactory.TwitterSearchEndpointConsumerBuilder initialDelay(long initialDelay) Milliseconds before the first poll starts. The option is a:longtype. Default: 1000 Group: scheduler- Parameters:
initialDelay- the value to set- Returns:
- the dsl builder
-
initialDelay
default TwitterSearchEndpointBuilderFactory.TwitterSearchEndpointConsumerBuilder initialDelay(String initialDelay) Milliseconds before the first poll starts. The option will be converted to alongtype. Default: 1000 Group: scheduler- Parameters:
initialDelay- the value to set- Returns:
- the dsl builder
-
repeatCount
default TwitterSearchEndpointBuilderFactory.TwitterSearchEndpointConsumerBuilder repeatCount(long repeatCount) Specifies a maximum limit of number of fires. So if you set it to 1, the scheduler will only fire once. If you set it to 5, it will only fire five times. A value of zero or negative means fire forever. The option is a:longtype. Default: 0 Group: scheduler- Parameters:
repeatCount- the value to set- Returns:
- the dsl builder
-
repeatCount
default TwitterSearchEndpointBuilderFactory.TwitterSearchEndpointConsumerBuilder repeatCount(String repeatCount) Specifies a maximum limit of number of fires. So if you set it to 1, the scheduler will only fire once. If you set it to 5, it will only fire five times. A value of zero or negative means fire forever. The option will be converted to alongtype. Default: 0 Group: scheduler- Parameters:
repeatCount- the value to set- Returns:
- the dsl builder
-
runLoggingLevel
default TwitterSearchEndpointBuilderFactory.TwitterSearchEndpointConsumerBuilder runLoggingLevel(org.apache.camel.LoggingLevel runLoggingLevel) The consumer logs a start/complete log line when it polls. This option allows you to configure the logging level for that. The option is a:org.apache.camel.LoggingLeveltype. Default: TRACE Group: scheduler- Parameters:
runLoggingLevel- the value to set- Returns:
- the dsl builder
-
runLoggingLevel
default TwitterSearchEndpointBuilderFactory.TwitterSearchEndpointConsumerBuilder runLoggingLevel(String runLoggingLevel) The consumer logs a start/complete log line when it polls. This option allows you to configure the logging level for that. The option will be converted to aorg.apache.camel.LoggingLeveltype. Default: TRACE Group: scheduler- Parameters:
runLoggingLevel- the value to set- Returns:
- the dsl builder
-
scheduledExecutorService
default TwitterSearchEndpointBuilderFactory.TwitterSearchEndpointConsumerBuilder scheduledExecutorService(ScheduledExecutorService scheduledExecutorService) Allows for configuring a custom/shared thread pool to use for the consumer. By default each consumer has its own single threaded thread pool. The option is a:java.util.concurrent.ScheduledExecutorServicetype. Group: scheduler- Parameters:
scheduledExecutorService- the value to set- Returns:
- the dsl builder
-
scheduledExecutorService
default TwitterSearchEndpointBuilderFactory.TwitterSearchEndpointConsumerBuilder scheduledExecutorService(String scheduledExecutorService) Allows for configuring a custom/shared thread pool to use for the consumer. By default each consumer has its own single threaded thread pool. The option will be converted to ajava.util.concurrent.ScheduledExecutorServicetype. Group: scheduler- Parameters:
scheduledExecutorService- the value to set- Returns:
- the dsl builder
-
scheduler
default TwitterSearchEndpointBuilderFactory.TwitterSearchEndpointConsumerBuilder scheduler(Object scheduler) To use a cron scheduler from either camel-spring or camel-quartz component. Use value spring or quartz for built in scheduler. The option is a:java.lang.Objecttype. Default: none Group: scheduler- Parameters:
scheduler- the value to set- Returns:
- the dsl builder
-
scheduler
default TwitterSearchEndpointBuilderFactory.TwitterSearchEndpointConsumerBuilder scheduler(String scheduler) To use a cron scheduler from either camel-spring or camel-quartz component. Use value spring or quartz for built in scheduler. The option will be converted to ajava.lang.Objecttype. Default: none Group: scheduler- Parameters:
scheduler- the value to set- Returns:
- the dsl builder
-
schedulerProperties
default TwitterSearchEndpointBuilderFactory.TwitterSearchEndpointConsumerBuilder schedulerProperties(String key, Object value) To configure additional properties when using a custom scheduler or any of the Quartz, Spring based scheduler. The option is a:java.util.Map<java.lang.String, java.lang.Object>type. The option is multivalued, and you can use the schedulerProperties(String, Object) method to add a value (call the method multiple times to set more values). Group: scheduler- Parameters:
key- the option keyvalue- the option value- Returns:
- the dsl builder
-
schedulerProperties
default TwitterSearchEndpointBuilderFactory.TwitterSearchEndpointConsumerBuilder schedulerProperties(Map values) To configure additional properties when using a custom scheduler or any of the Quartz, Spring based scheduler. The option is a:java.util.Map<java.lang.String, java.lang.Object>type. The option is multivalued, and you can use the schedulerProperties(String, Object) method to add a value (call the method multiple times to set more values). Group: scheduler- Parameters:
values- the values- Returns:
- the dsl builder
-
startScheduler
default TwitterSearchEndpointBuilderFactory.TwitterSearchEndpointConsumerBuilder startScheduler(boolean startScheduler) Whether the scheduler should be auto started. The option is a:booleantype. Default: true Group: scheduler- Parameters:
startScheduler- the value to set- Returns:
- the dsl builder
-
startScheduler
default TwitterSearchEndpointBuilderFactory.TwitterSearchEndpointConsumerBuilder startScheduler(String startScheduler) Whether the scheduler should be auto started. The option will be converted to abooleantype. Default: true Group: scheduler- Parameters:
startScheduler- the value to set- Returns:
- the dsl builder
-
timeUnit
default TwitterSearchEndpointBuilderFactory.TwitterSearchEndpointConsumerBuilder timeUnit(TimeUnit timeUnit) Time unit for initialDelay and delay options. The option is a:java.util.concurrent.TimeUnittype. Default: MILLISECONDS Group: scheduler- Parameters:
timeUnit- the value to set- Returns:
- the dsl builder
-
timeUnit
default TwitterSearchEndpointBuilderFactory.TwitterSearchEndpointConsumerBuilder timeUnit(String timeUnit) Time unit for initialDelay and delay options. The option will be converted to ajava.util.concurrent.TimeUnittype. Default: MILLISECONDS Group: scheduler- Parameters:
timeUnit- the value to set- Returns:
- the dsl builder
-
useFixedDelay
default TwitterSearchEndpointBuilderFactory.TwitterSearchEndpointConsumerBuilder useFixedDelay(boolean useFixedDelay) Controls if fixed delay or fixed rate is used. See ScheduledExecutorService in JDK for details. The option is a:booleantype. Default: true Group: scheduler- Parameters:
useFixedDelay- the value to set- Returns:
- the dsl builder
-
useFixedDelay
default TwitterSearchEndpointBuilderFactory.TwitterSearchEndpointConsumerBuilder useFixedDelay(String useFixedDelay) Controls if fixed delay or fixed rate is used. See ScheduledExecutorService in JDK for details. The option will be converted to abooleantype. Default: true Group: scheduler- Parameters:
useFixedDelay- the value to set- Returns:
- the dsl builder
-
accessToken
default TwitterSearchEndpointBuilderFactory.TwitterSearchEndpointConsumerBuilder accessToken(String accessToken) The access token. Can also be configured on the TwitterComponent level instead. The option is a:java.lang.Stringtype. Group: security- Parameters:
accessToken- the value to set- Returns:
- the dsl builder
-
accessTokenSecret
default TwitterSearchEndpointBuilderFactory.TwitterSearchEndpointConsumerBuilder accessTokenSecret(String accessTokenSecret) The access secret. Can also be configured on the TwitterComponent level instead. The option is a:java.lang.Stringtype. Group: security- Parameters:
accessTokenSecret- the value to set- Returns:
- the dsl builder
-
consumerKey
default TwitterSearchEndpointBuilderFactory.TwitterSearchEndpointConsumerBuilder consumerKey(String consumerKey) The consumer key. Can also be configured on the TwitterComponent level instead. The option is a:java.lang.Stringtype. Group: security- Parameters:
consumerKey- the value to set- Returns:
- the dsl builder
-
consumerSecret
default TwitterSearchEndpointBuilderFactory.TwitterSearchEndpointConsumerBuilder consumerSecret(String consumerSecret) The consumer secret. Can also be configured on the TwitterComponent level instead. The option is a:java.lang.Stringtype. Group: security- Parameters:
consumerSecret- the value to set- Returns:
- the dsl builder
-
sortById
default TwitterSearchEndpointBuilderFactory.TwitterSearchEndpointConsumerBuilder sortById(boolean sortById) Sorts by id, so the oldest are first, and newest last. The option is a:booleantype. Default: true Group: sort- Parameters:
sortById- the value to set- Returns:
- the dsl builder
-
sortById
default TwitterSearchEndpointBuilderFactory.TwitterSearchEndpointConsumerBuilder sortById(String sortById) Sorts by id, so the oldest are first, and newest last. The option will be converted to abooleantype. Default: true Group: sort- Parameters:
sortById- the value to set- Returns:
- the dsl builder
-