Class: Vertx::Vertx
- Inherits:
-
Object
- Object
- Vertx::Vertx
- Includes:
- Measured
- Defined in:
- /Users/julien/java/vertx-stack/stack-docs/target/rb/vertx/vertx.rb
Overview
You use an instance of this class for functionality including:
- Creating TCP clients and servers
- Creating HTTP clients and servers
- Creating DNS clients
- Creating Datagram sockets
- Setting and cancelling periodic and one-shot timers
- Getting a reference to the event bus API
- Getting a reference to the file system API
- Getting a reference to the shared data API
- Deploying and undeploying verticles
Most functionality in Vert.x core is fairly low level.
To create an instance of this class you can use the static factory methods: #vertx, #vertx and #clustered_vertx.
Please see the user manual for more detailed usage information.
Class Method Summary (collapse)
-
+ (void) clustered_vertx(options = nil) { ... }
Creates a clustered instance using the specified options.
-
+ (::Vertx::Context) current_context
Gets the current context.
-
+ (::Vertx::Vertx) vertx(options = nil)
Creates a non clustered instance using the specified options.
Instance Method Summary (collapse)
-
- (true, false) cancel_timer?(id = nil)
Cancels the timer with the specified id.
-
- (void) close { ... }
Like #close but the completionHandler will be called when the close is complete.
-
- (true, false) clustered?
Is this Vert.x instance clustered?.
-
- (::Vertx::DatagramSocket) create_datagram_socket(options = nil)
Create a datagram socket using the specified options.
-
- (::Vertx::DnsClient) create_dns_client(port = nil, host = nil)
Create a DNS client to connect to a DNS server at the specified host and port.
-
- (::Vertx::HttpClient) create_http_client(options = nil)
Create a HTTP/HTTPS client using the specified options.
-
- (::Vertx::HttpServer) create_http_server(options = nil)
Create an HTTP/HTTPS server using the specified options.
-
- (::Vertx::NetClient) create_net_client(options = nil)
Create a TCP/SSL client using the specified options.
-
- (::Vertx::NetServer) create_net_server(options = nil)
Create a TCP/SSL server using the specified options.
-
- (::Vertx::WorkerExecutor) create_shared_worker_executor(name = nil, poolSize = nil, maxExecuteTime = nil)
Create a named worker executor, the executor should be closed when it's not needed anymore to release resources.
-
- (void) deploy_verticle(name = nil, options = nil) { ... }
Like #deploy_verticle but Hash are provided to configure the deployment.
-
- (Set<String>) deployment_i_ds
Return a Set of deployment IDs for the currently deployed deploymentIDs.
-
- (::Vertx::EventBus) event_bus
Get the event bus object.
-
- (self) exception_handler { ... }
Set a default exception handler for Context, set on at creation.
-
- (void) execute_blocking(blockingCodeHandler = nil, ordered = nil) { ... }
Safely execute some blocking code.
-
- (::Vertx::FileSystem) file_system
Get the filesystem object.
-
- (::Vertx::Context) get_or_create_context
Gets the current context, or creates one if there isn't one.
-
- (true, false) metrics_enabled?
Whether the metrics are enabled for this measured object.
-
- (::Vertx::TimeoutStream) periodic_stream(delay = nil)
Returns a periodic timer as a read stream.
-
- (void) run_on_context { ... }
Puts the handler on the event queue for the current context so it will be run asynchronously ASAP after all preceeding events have been handled.
-
- (Fixnum) set_periodic(delay = nil) { ... }
Set a periodic timer to fire every delay milliseconds, at which point handler will be called with the id of the timer.
-
- (Fixnum) set_timer(delay = nil) { ... }
Set a one-shot timer to fire after delay milliseconds, at which point handler will be called with the id of the timer.
-
- (::Vertx::SharedData) shared_data
Get the shared data object.
-
- (::Vertx::TimeoutStream) timer_stream(delay = nil)
Returns a one-shot timer as a read stream.
-
- (void) undeploy(deploymentID = nil) { ... }
Like #undeploy(String) but the completionHandler will be notified when the undeployment is complete.
Class Method Details
+ (void) clustered_vertx(options = nil) { ... }
This method returns an undefined value.
Creates a clustered instance using the specified options.The instance is created asynchronously and the resultHandler is called with the result when it is ready.
76 77 78 79 80 81 |
# File '/Users/julien/java/vertx-stack/stack-docs/target/rb/vertx/vertx.rb', line 76 def self.clustered_vertx(=nil) if .class == Hash && block_given? return Java::IoVertxCore::Vertx.java_method(:clusteredVertx, [Java::IoVertxCore::VertxOptions.java_class,Java::IoVertxCore::Handler.java_class]).call(Java::IoVertxCore::VertxOptions.new(::Vertx::Util::Utils.to_json_object()),(Proc.new { |ar| yield(ar.failed ? ar.cause : nil, ar.succeeded ? ::Vertx::Util::Utils.safe_create(ar.result,::Vertx::Vertx) : nil) })) end raise ArgumentError, "Invalid arguments when calling clustered_vertx(options)" end |
+ (::Vertx::Context) current_context
84 85 86 87 88 89 |
# File '/Users/julien/java/vertx-stack/stack-docs/target/rb/vertx/vertx.rb', line 84 def self.current_context if !block_given? return ::Vertx::Util::Utils.safe_create(Java::IoVertxCore::Vertx.java_method(:currentContext, []).call(),::Vertx::Context) end raise ArgumentError, "Invalid arguments when calling current_context()" end |
+ (::Vertx::Vertx) vertx(options = nil)
62 63 64 65 66 67 68 69 |
# File '/Users/julien/java/vertx-stack/stack-docs/target/rb/vertx/vertx.rb', line 62 def self.vertx(=nil) if !block_given? && == nil return ::Vertx::Util::Utils.safe_create(Java::IoVertxCore::Vertx.java_method(:vertx, []).call(),::Vertx::Vertx) elsif .class == Hash && !block_given? return ::Vertx::Util::Utils.safe_create(Java::IoVertxCore::Vertx.java_method(:vertx, [Java::IoVertxCore::VertxOptions.java_class]).call(Java::IoVertxCore::VertxOptions.new(::Vertx::Util::Utils.to_json_object())),::Vertx::Vertx) end raise ArgumentError, "Invalid arguments when calling vertx(options)" end |
Instance Method Details
- (true, false) cancel_timer?(id = nil)
id
.
241 242 243 244 245 246 |
# File '/Users/julien/java/vertx-stack/stack-docs/target/rb/vertx/vertx.rb', line 241 def cancel_timer?(id=nil) if id.class == Fixnum && !block_given? return @j_del.java_method(:cancelTimer, [Java::long.java_class]).call(id) end raise ArgumentError, "Invalid arguments when calling cancel_timer?(id)" end |
- (void) close { ... }
This method returns an undefined value.
Like #close but the completionHandler will be called when the close is complete
260 261 262 263 264 265 266 267 |
# File '/Users/julien/java/vertx-stack/stack-docs/target/rb/vertx/vertx.rb', line 260 def close if !block_given? return @j_del.java_method(:close, []).call() elsif block_given? return @j_del.java_method(:close, [Java::IoVertxCore::Handler.java_class]).call((Proc.new { |ar| yield(ar.failed ? ar.cause : nil) })) end raise ArgumentError, "Invalid arguments when calling close()" end |
- (true, false) clustered?
308 309 310 311 312 313 |
# File '/Users/julien/java/vertx-stack/stack-docs/target/rb/vertx/vertx.rb', line 308 def clustered? if !block_given? return @j_del.java_method(:isClustered, []).call() end raise ArgumentError, "Invalid arguments when calling clustered?()" end |
- (::Vertx::DatagramSocket) create_datagram_socket(options = nil)
145 146 147 148 149 150 151 152 |
# File '/Users/julien/java/vertx-stack/stack-docs/target/rb/vertx/vertx.rb', line 145 def create_datagram_socket(=nil) if !block_given? && == nil return ::Vertx::Util::Utils.safe_create(@j_del.java_method(:createDatagramSocket, []).call(),::Vertx::DatagramSocket) elsif .class == Hash && !block_given? return ::Vertx::Util::Utils.safe_create(@j_del.java_method(:createDatagramSocket, [Java::IoVertxCoreDatagram::DatagramSocketOptions.java_class]).call(Java::IoVertxCoreDatagram::DatagramSocketOptions.new(::Vertx::Util::Utils.to_json_object())),::Vertx::DatagramSocket) end raise ArgumentError, "Invalid arguments when calling create_datagram_socket(options)" end |
- (::Vertx::DnsClient) create_dns_client(port = nil, host = nil)
179 180 181 182 183 184 |
# File '/Users/julien/java/vertx-stack/stack-docs/target/rb/vertx/vertx.rb', line 179 def create_dns_client(port=nil,host=nil) if port.class == Fixnum && host.class == String && !block_given? return ::Vertx::Util::Utils.safe_create(@j_del.java_method(:createDnsClient, [Java::int.java_class,Java::java.lang.String.java_class]).call(port,host),::Vertx::DnsClient) end raise ArgumentError, "Invalid arguments when calling create_dns_client(port,host)" end |
- (::Vertx::HttpClient) create_http_client(options = nil)
134 135 136 137 138 139 140 141 |
# File '/Users/julien/java/vertx-stack/stack-docs/target/rb/vertx/vertx.rb', line 134 def create_http_client(=nil) if !block_given? && == nil return ::Vertx::Util::Utils.safe_create(@j_del.java_method(:createHttpClient, []).call(),::Vertx::HttpClient) elsif .class == Hash && !block_given? return ::Vertx::Util::Utils.safe_create(@j_del.java_method(:createHttpClient, [Java::IoVertxCoreHttp::HttpClientOptions.java_class]).call(Java::IoVertxCoreHttp::HttpClientOptions.new(::Vertx::Util::Utils.to_json_object())),::Vertx::HttpClient) end raise ArgumentError, "Invalid arguments when calling create_http_client(options)" end |
- (::Vertx::HttpServer) create_http_server(options = nil)
123 124 125 126 127 128 129 130 |
# File '/Users/julien/java/vertx-stack/stack-docs/target/rb/vertx/vertx.rb', line 123 def create_http_server(=nil) if !block_given? && == nil return ::Vertx::Util::Utils.safe_create(@j_del.java_method(:createHttpServer, []).call(),::Vertx::HttpServer) elsif .class == Hash && !block_given? return ::Vertx::Util::Utils.safe_create(@j_del.java_method(:createHttpServer, [Java::IoVertxCoreHttp::HttpServerOptions.java_class]).call(Java::IoVertxCoreHttp::HttpServerOptions.new(::Vertx::Util::Utils.to_json_object())),::Vertx::HttpServer) end raise ArgumentError, "Invalid arguments when calling create_http_server(options)" end |
- (::Vertx::NetClient) create_net_client(options = nil)
112 113 114 115 116 117 118 119 |
# File '/Users/julien/java/vertx-stack/stack-docs/target/rb/vertx/vertx.rb', line 112 def create_net_client(=nil) if !block_given? && == nil return ::Vertx::Util::Utils.safe_create(@j_del.java_method(:createNetClient, []).call(),::Vertx::NetClient) elsif .class == Hash && !block_given? return ::Vertx::Util::Utils.safe_create(@j_del.java_method(:createNetClient, [Java::IoVertxCoreNet::NetClientOptions.java_class]).call(Java::IoVertxCoreNet::NetClientOptions.new(::Vertx::Util::Utils.to_json_object())),::Vertx::NetClient) end raise ArgumentError, "Invalid arguments when calling create_net_client(options)" end |
- (::Vertx::NetServer) create_net_server(options = nil)
101 102 103 104 105 106 107 108 |
# File '/Users/julien/java/vertx-stack/stack-docs/target/rb/vertx/vertx.rb', line 101 def create_net_server(=nil) if !block_given? && == nil return ::Vertx::Util::Utils.safe_create(@j_del.java_method(:createNetServer, []).call(),::Vertx::NetServer) elsif .class == Hash && !block_given? return ::Vertx::Util::Utils.safe_create(@j_del.java_method(:createNetServer, [Java::IoVertxCoreNet::NetServerOptions.java_class]).call(Java::IoVertxCoreNet::NetServerOptions.new(::Vertx::Util::Utils.to_json_object())),::Vertx::NetServer) end raise ArgumentError, "Invalid arguments when calling create_net_server(options)" end |
- (::Vertx::WorkerExecutor) create_shared_worker_executor(name = nil, poolSize = nil, maxExecuteTime = nil)
name
. Executors with the same name will share
the same worker pool. The worker pool size and max execute time are set when the worker pool is created and
won't change after.The worker pool is released when all the WorkerExecutor sharing the same name are closed.
351 352 353 354 355 356 357 358 359 360 |
# File '/Users/julien/java/vertx-stack/stack-docs/target/rb/vertx/vertx.rb', line 351 def create_shared_worker_executor(name=nil,poolSize=nil,maxExecuteTime=nil) if name.class == String && !block_given? && poolSize == nil && maxExecuteTime == nil return ::Vertx::Util::Utils.safe_create(@j_del.java_method(:createSharedWorkerExecutor, [Java::java.lang.String.java_class]).call(name),::Vertx::WorkerExecutor) elsif name.class == String && poolSize.class == Fixnum && !block_given? && maxExecuteTime == nil return ::Vertx::Util::Utils.safe_create(@j_del.java_method(:createSharedWorkerExecutor, [Java::java.lang.String.java_class,Java::int.java_class]).call(name,poolSize),::Vertx::WorkerExecutor) elsif name.class == String && poolSize.class == Fixnum && maxExecuteTime.class == Fixnum && !block_given? return ::Vertx::Util::Utils.safe_create(@j_del.java_method(:createSharedWorkerExecutor, [Java::java.lang.String.java_class,Java::int.java_class,Java::long.java_class]).call(name,poolSize,maxExecuteTime),::Vertx::WorkerExecutor) end raise ArgumentError, "Invalid arguments when calling create_shared_worker_executor(name,poolSize,maxExecuteTime)" end |
- (void) deploy_verticle(name = nil, options = nil) { ... }
This method returns an undefined value.
Like #deploy_verticle but Hash are provided to configure the deployment.
274 275 276 277 278 279 280 281 282 283 284 285 |
# File '/Users/julien/java/vertx-stack/stack-docs/target/rb/vertx/vertx.rb', line 274 def deploy_verticle(name=nil,=nil) if name.class == String && !block_given? && == nil return @j_del.java_method(:deployVerticle, [Java::java.lang.String.java_class]).call(name) elsif name.class == String && block_given? && == nil return @j_del.java_method(:deployVerticle, [Java::java.lang.String.java_class,Java::IoVertxCore::Handler.java_class]).call(name,(Proc.new { |ar| yield(ar.failed ? ar.cause : nil, ar.succeeded ? ar.result : nil) })) elsif name.class == String && .class == Hash && !block_given? return @j_del.java_method(:deployVerticle, [Java::java.lang.String.java_class,Java::IoVertxCore::DeploymentOptions.java_class]).call(name,Java::IoVertxCore::DeploymentOptions.new(::Vertx::Util::Utils.to_json_object())) elsif name.class == String && .class == Hash && block_given? return @j_del.java_method(:deployVerticle, [Java::java.lang.String.java_class,Java::IoVertxCore::DeploymentOptions.java_class,Java::IoVertxCore::Handler.java_class]).call(name,Java::IoVertxCore::DeploymentOptions.new(::Vertx::Util::Utils.to_json_object()),(Proc.new { |ar| yield(ar.failed ? ar.cause : nil, ar.succeeded ? ar.result : nil) })) end raise ArgumentError, "Invalid arguments when calling deploy_verticle(name,options)" end |
- (Set<String>) deployment_i_ds
300 301 302 303 304 305 |
# File '/Users/julien/java/vertx-stack/stack-docs/target/rb/vertx/vertx.rb', line 300 def deployment_i_ds if !block_given? return ::Vertx::Util::Utils.to_set(@j_del.java_method(:deploymentIDs, []).call()).map! { |elt| elt } end raise ArgumentError, "Invalid arguments when calling deployment_i_ds()" end |
- (::Vertx::EventBus) event_bus
166 167 168 169 170 171 172 173 174 |
# File '/Users/julien/java/vertx-stack/stack-docs/target/rb/vertx/vertx.rb', line 166 def event_bus if !block_given? if @cached_event_bus != nil return @cached_event_bus end return @cached_event_bus = ::Vertx::Util::Utils.safe_create(@j_del.java_method(:eventBus, []).call(),::Vertx::EventBus) end raise ArgumentError, "Invalid arguments when calling event_bus()" end |
- (self) exception_handler { ... }
364 365 366 367 368 369 370 |
# File '/Users/julien/java/vertx-stack/stack-docs/target/rb/vertx/vertx.rb', line 364 def exception_handler if block_given? @j_del.java_method(:exceptionHandler, [Java::IoVertxCore::Handler.java_class]).call((Proc.new { |event| yield(::Vertx::Util::Utils.from_throwable(event)) })) return self end raise ArgumentError, "Invalid arguments when calling exception_handler()" end |
- (void) execute_blocking(blockingCodeHandler = nil, ordered = nil) { ... }
This method returns an undefined value.
Safely execute some blocking code.
Executes the blocking code in the handler blockingCodeHandler
using a thread from the worker pool.
When the code is complete the handler resultHandler
will be called with the result on the original context
(e.g. on the original event loop of the caller).
A Future
instance is passed into blockingCodeHandler
. When the blocking code successfully completes,
the handler should call the Future#complete or Future#complete method, or the Future#fail
method if it failed.
In the blockingCodeHandler
the current context remains the original context and therefore any task
scheduled in the blockingCodeHandler
will be executed on the this context and not on the worker thread.
331 332 333 334 335 336 337 338 |
# File '/Users/julien/java/vertx-stack/stack-docs/target/rb/vertx/vertx.rb', line 331 def execute_blocking(blockingCodeHandler=nil,ordered=nil) if blockingCodeHandler.class == Proc && block_given? && ordered == nil return @j_del.java_method(:executeBlocking, [Java::IoVertxCore::Handler.java_class,Java::IoVertxCore::Handler.java_class]).call((Proc.new { |event| blockingCodeHandler.call(::Vertx::Util::Utils.safe_create(event,::Vertx::Future)) }),(Proc.new { |ar| yield(ar.failed ? ar.cause : nil, ar.succeeded ? ::Vertx::Util::Utils.from_object(ar.result) : nil) })) elsif blockingCodeHandler.class == Proc && (ordered.class == TrueClass || ordered.class == FalseClass) && block_given? return @j_del.java_method(:executeBlocking, [Java::IoVertxCore::Handler.java_class,Java::boolean.java_class,Java::IoVertxCore::Handler.java_class]).call((Proc.new { |event| blockingCodeHandler.call(::Vertx::Util::Utils.safe_create(event,::Vertx::Future)) }),ordered,(Proc.new { |ar| yield(ar.failed ? ar.cause : nil, ar.succeeded ? ::Vertx::Util::Utils.from_object(ar.result) : nil) })) end raise ArgumentError, "Invalid arguments when calling execute_blocking(blockingCodeHandler,ordered)" end |
- (::Vertx::FileSystem) file_system
155 156 157 158 159 160 161 162 163 |
# File '/Users/julien/java/vertx-stack/stack-docs/target/rb/vertx/vertx.rb', line 155 def file_system if !block_given? if @cached_file_system != nil return @cached_file_system end return @cached_file_system = ::Vertx::Util::Utils.safe_create(@j_del.java_method(:fileSystem, []).call(),::Vertx::FileSystem) end raise ArgumentError, "Invalid arguments when calling file_system()" end |
- (::Vertx::Context) get_or_create_context
92 93 94 95 96 97 |
# File '/Users/julien/java/vertx-stack/stack-docs/target/rb/vertx/vertx.rb', line 92 def get_or_create_context if !block_given? return ::Vertx::Util::Utils.safe_create(@j_del.java_method(:getOrCreateContext, []).call(),::Vertx::Context) end raise ArgumentError, "Invalid arguments when calling get_or_create_context()" end |
- (true, false) metrics_enabled?
53 54 55 56 57 58 |
# File '/Users/julien/java/vertx-stack/stack-docs/target/rb/vertx/vertx.rb', line 53 def metrics_enabled? if !block_given? return @j_del.java_method(:isMetricsEnabled, []).call() end raise ArgumentError, "Invalid arguments when calling metrics_enabled?()" end |
- (::Vertx::TimeoutStream) periodic_stream(delay = nil)
delay
milliseconds after
the has been called.
232 233 234 235 236 237 |
# File '/Users/julien/java/vertx-stack/stack-docs/target/rb/vertx/vertx.rb', line 232 def periodic_stream(delay=nil) if delay.class == Fixnum && !block_given? return ::Vertx::Util::Utils.safe_create(@j_del.java_method(:periodicStream, [Java::long.java_class]).call(delay),::Vertx::TimeoutStream) end raise ArgumentError, "Invalid arguments when calling periodic_stream(delay)" end |
- (void) run_on_context { ... }
This method returns an undefined value.
Puts the handler on the event queue for the current context so it will be run asynchronously ASAP after all preceeding events have been handled.
251 252 253 254 255 256 |
# File '/Users/julien/java/vertx-stack/stack-docs/target/rb/vertx/vertx.rb', line 251 def run_on_context if block_given? return @j_del.java_method(:runOnContext, [Java::IoVertxCore::Handler.java_class]).call(Proc.new { yield }) end raise ArgumentError, "Invalid arguments when calling run_on_context()" end |
- (Fixnum) set_periodic(delay = nil) { ... }
delay
milliseconds, at which point handler
will be called with
the id of the timer.
222 223 224 225 226 227 |
# File '/Users/julien/java/vertx-stack/stack-docs/target/rb/vertx/vertx.rb', line 222 def set_periodic(delay=nil) if delay.class == Fixnum && block_given? return @j_del.java_method(:setPeriodic, [Java::long.java_class,Java::IoVertxCore::Handler.java_class]).call(delay,(Proc.new { |event| yield(event) })) end raise ArgumentError, "Invalid arguments when calling set_periodic(delay)" end |
- (Fixnum) set_timer(delay = nil) { ... }
delay
milliseconds, at which point handler
will be called with
the id of the timer.
201 202 203 204 205 206 |
# File '/Users/julien/java/vertx-stack/stack-docs/target/rb/vertx/vertx.rb', line 201 def set_timer(delay=nil) if delay.class == Fixnum && block_given? return @j_del.java_method(:setTimer, [Java::long.java_class,Java::IoVertxCore::Handler.java_class]).call(delay,(Proc.new { |event| yield(event) })) end raise ArgumentError, "Invalid arguments when calling set_timer(delay)" end |
- (::Vertx::SharedData) shared_data
187 188 189 190 191 192 193 194 195 |
# File '/Users/julien/java/vertx-stack/stack-docs/target/rb/vertx/vertx.rb', line 187 def shared_data if !block_given? if @cached_shared_data != nil return @cached_shared_data end return @cached_shared_data = ::Vertx::Util::Utils.safe_create(@j_del.java_method(:sharedData, []).call(),::Vertx::SharedData) end raise ArgumentError, "Invalid arguments when calling shared_data()" end |
- (::Vertx::TimeoutStream) timer_stream(delay = nil)
delay
milliseconds after
the has been called.
211 212 213 214 215 216 |
# File '/Users/julien/java/vertx-stack/stack-docs/target/rb/vertx/vertx.rb', line 211 def timer_stream(delay=nil) if delay.class == Fixnum && !block_given? return ::Vertx::Util::Utils.safe_create(@j_del.java_method(:timerStream, [Java::long.java_class]).call(delay),::Vertx::TimeoutStream) end raise ArgumentError, "Invalid arguments when calling timer_stream(delay)" end |
- (void) undeploy(deploymentID = nil) { ... }
This method returns an undefined value.
Like #undeploy(String) but the completionHandler will be notified when the undeployment is complete.
290 291 292 293 294 295 296 297 |
# File '/Users/julien/java/vertx-stack/stack-docs/target/rb/vertx/vertx.rb', line 290 def undeploy(deploymentID=nil) if deploymentID.class == String && !block_given? return @j_del.java_method(:undeploy, [Java::java.lang.String.java_class]).call(deploymentID) elsif deploymentID.class == String && block_given? return @j_del.java_method(:undeploy, [Java::java.lang.String.java_class,Java::IoVertxCore::Handler.java_class]).call(deploymentID,(Proc.new { |ar| yield(ar.failed ? ar.cause : nil) })) end raise ArgumentError, "Invalid arguments when calling undeploy(deploymentID)" end |