Play Framework/Scala example source code file (WS.java)

This example Play Framework source code file (WS.java) is included in my "Source Code Warehouse" project. The intent of this project is to help you more easily find Play Framework (and Scala) source code examples by using tags.

All credit for the original source code belongs to Play Framework; I'm just trying to make examples easier to find. (For my Scala work, see my Scala examples and tutorials.)

Play Framework tags/keywords

application, illegalstateexception, lib, library, play, play framework, web service, ws, wsclient, wsplugin, wsrequestholder

The WS.java Play Framework example source code

/*
 * Copyright (C) 2009-2013 Typesafe Inc. <http://www.typesafe.com>
 */
package play.libs.ws;

import play.Application;

/**
 * Asynchronous API to to query web services, as an http client.
 *
 * The value returned is a {@code Promise<Response>}, and you should use Play's asynchronous mechanisms to use this response.
 */
public class WS {

    public static WSClient client() {
        Application app = play.Play.application();
        WSPlugin wsPlugin = app.plugin(WSPlugin.class);
        if (wsPlugin.enabled() && wsPlugin.loaded()) {
            return wsPlugin.api().client();
        } else {
            throw new IllegalStateException("WSPlugin is not loaded / enabled!");
        }
    }

    /**
     * Prepare a new request. You can then construct it by chaining calls.
     *
     * @param url the URL to request
     */
    public static WSRequestHolder url(String url) {
        return client().url(url);
    }

}