HelloSseClient.java

/*
 * Copyright 2015 Netflix, Inc.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 *
 */

package io.reactivex.netty.examples.http.sse;

import io.netty.handler.logging.LogLevel;
import io.reactivex.netty.examples.ExamplesEnvironment;
import io.reactivex.netty.protocol.http.client.HttpClient;
import io.reactivex.netty.protocol.http.client.HttpClientResponse;
import org.slf4j.Logger;

import java.net.SocketAddress;

/**
 * An <a href="http://www.w3.org/TR/eventsource/">Server sent event</a> "Hello World" example client.
 *
 * This example assumes that the server to which this client connects (using the below mentioned option), sends an
 * infinite Server Sent Event stream adhering to the specifications. This client only takes 10 items from that infinite
 * stream and then terminates the connection.
 *
 * There are three ways of running this example:
 *
 * <h2>Default</h2>
 *
 * The default way is to just run this class with no arguments, which will start a server ({@link HelloSseServer}) on
 * an ephemeral port and then send an HTTP request to that server and print the response.
 *
 * <h2>After starting {@link HelloSseServer}</h2>
 *
 * If you want to see how {@link HelloSseServer} work, you can run {@link HelloSseServer} by yourself and then pass
 * the port on which the server started to this class as a program argument:
 *
 <PRE>
    java io.reactivex.netty.examples.http.sse.HelloSseClient [server port]
 </PRE>
 *
 * <h2>Existing HTTP server</h2>
 *
 * You can also use this client to send a GET request "/sse" to an existing HTTP server (different than
 * {@link HelloSseServer}) by passing the port and host of the existing server similar to the case above:
 *
 <PRE>
    java io.reactivex.netty.examples.http.sse.HelloSseClient [server port] [server host]
 </PRE>
 * If the server host is omitted from the above, it defaults to "127.0.0.1"
 *
 * In all the above usages, this client will print the response received from the server.
 *
 * @see HelloSseServer Default server for this client.
 */
public final class HelloSseClient {

    public static void main(String[] args) {

        ExamplesEnvironment env = ExamplesEnvironment.newEnvironment(HelloSseClient.class);
        Logger logger = env.getLogger();

        /*
         * Retrieves the server address, using the following algorithm:
         * <ul>
             <li>If any arguments are passed, then use the first argument as the server port.</li>
             <li>If available, use the second argument as the server host, else default to localhost</li>
             <li>Otherwise, start the passed server class and use that address.</li>
         </ul>
         */
        SocketAddress serverAddress = env.getServerAddress(HelloSseServer.class, args);

        /*Create a new client for the server address*/
        HttpClient.newClient(serverAddress)
                  .enableWireLogging("inter-client", LogLevel.DEBUG)
                  .createGet("/sse")
                  .doOnNext(resp -> logger.info(resp.toString()))
                  .flatMap(HttpClientResponse::getContentAsServerSentEvents)
                  .take(10)
                  .toBlocking()
                  .forEach(sse -> logger.info(sse.toString()));
    }
}