1 Overview of Standalone Clients

A standalone client is a client that has a run-time environment independent of WebLogic Server. (Managed clients, such as Web Services, rely on a server-side container to provide the run time necessary to access a server.) Standalone clients that access WebLogic Server applications range from simple command-line utilities that use standard I/O to highly interactive GUI applications built using the Java Swing/AWT classes. Learn about types of clients, client features, and how clients are distributed.

Distributing Client Jar Files

Learn about license requirements when using client JARs and other resources provided in Oracle WebLogic Server for creating standalone clients.

See Stand-Alone WebLogic Clients.

WebLogic T3 Clients

The WebLogic T3 clients are Java RMI clients that use Oracle's T3 protocol to communicate with WebLogic Server. T3 clients outperform other client types, and are the most recommended type of client.

WebLogic Thin T3 Client

The WebLogic Thin T3 java client provides a light-weight alternative to the WebLogic Install, Full, and Thin IIOP clients. This client provides the same performance that you would see with the full client, but leverages a much smaller jar file. The Thin T3 client supports most of the use cases in which the full client can be used.

The Thin T3 client can be used in standalone applications, and is also designed for applications running on foreign (non-WebLogic) servers. One common use case is integration with WebLogic JMS destinations.

WebLogic Full Client (Deprecated)

The WebLogic Full Client requires the largest JAR file (wlfullclient.jar) among the standalone clients, but it has the most features and is the best overall performer. All three T3 clients have the same performance. The wlfullclient.jar also provides IIOP support. See:

Note:

If you run the WebLogic Full Client from a <java> task that is invoked in an Ant script, see Running the WebLogic Full Client in a Non-Forked VM, for important information regarding the RSA Crypto-J library, which is included in the wlfullclient.jar manifest classpath.

WebLogic Install Client

The Install client is available from a full WebLogic Server installation. It uses the weblogic.jar file located at WL_HOME/server/lib and provides client-side support for all WebLogic Server-specific value-added features. It is the only client that supports server-side operations, such as:

  • Operations necessary for development purposes, such as the ejbc compiler.

  • Administrative operations such as deployment.

  • WLST and client-side JSR 88 applications that invoke server-side operations.

RMI-IIOP (Deprecated)

IIOP can be a transport protocol for distributed applications with interfaces written in Java RMI. When there is an option, Oracle recommends using T3 clients instead of IIOP clients.

See Using RMI over IIOP in Developing RMI Applications for Oracle WebLogic Server.

CORBA Clients

If you are not working in a Java-only environment, you can use IIOP to connect your Java programs with Common Object Request Broker Architecture (CORBA) clients and execute CORBA objects. IIOP can be a transport protocol for distributed applications with interfaces written in Interface Definition Language (IDL) or Java RMI. However, the two models are distinctly different approaches to creating an interoperable environment between heterogeneous systems.

When you program, you must decide to use either IDL or RMI interfaces; you cannot mix them. WebLogic Server supports the following CORBA client models:

JMX Clients

You can use a JMX client to access WebLogic Server MBeans.

See Accessing WebLogic Server MBeans With JMX in Developing Custom Management Utilities Using JMX for Oracle WebLogic Server.

JMS Clients

WebLogic Server provides a number of JMS clients that provide Java EE and WebLogic JMS functionality.

Tip:

Oracle WebLogic JMS clients require using the T3 protocol in all cases except for the JMS thin client (deprecated). The JMS thin client (deprecated) always uses the slower IIOP protocol and is only recommended when the Thin T3 client is considered to be too large for your use case.

Web Services Clients

WebLogic Server provides standalone Web Services clients that enable a Java SE client to invoke a Web Service hosted on WebLogic Server or on other application servers. These clients are listed in Table 1-1. For more information on use of these clients, see Invoking a Web Service from a Standalone Java SE Client in Developing JAX-RPC Web Services for Oracle WebLogic Server.

WebLogic Tuxedo Connector Clients

WebLogic Tuxedo Connector provides interoperability between WebLogic Server applications and Tuxedo services.

See:

Clients and Features

Learn about the types of clients and its features supported in a WebLogic Server environment.

The following table lists the types of clients supported in a WebLogic Server environment, and their characteristics, features, and limitations.

Note:

Oracle does not support combining clients to create extended feature sets. Select a client that best fits your environment and use only the client classes specified for that client type.

Table 1-1 WebLogic Server Client Types and Features

Client Type Language Protocol Client Class Requirements Key Features

WL Thin T3 Client

RMI

Java

T3

wlthint3client.jar

  • Small Footprint.

  • Oracle WebLogic's T3/T3S protocol for Remote Method Invocation (RMI).

  • Supports WebLogic Server clustering.

  • Supports JSSE SSL, except with HTTP tunnelling.

  • Faster and more scalable than IIOP clients.

  • Most WebLogic client JMS features, including the WebLogic Store-and-Forward (SAF) Service using the wlsaft3client.jar.

  • Supports most Java EE features.

  • See Developing a WebLogic Thin T3 Client.

Install Client

RMI

Java

IIOP

weblogic.jar

  • Supports JSSE SSL.

  • Supports most of the Java EE features, but does not support WebLogic client JMS.

  • Operations necessary for development purposes, such as the ejbc compiler.

  • Supports administrative operations such as deployment.

  • Supports WLST and client-side JSR 88 applications that invoke server-side operations.

  • See WebLogic Install Client.

Install Client

RMI

Java

T3

weblogic.jar

  • Supports Oracle WebLogic's T3/T3S protocol for Remote Method Invocation (RMI), including HTTP Tunneling of T3/T3S.

  • Supports WebLogic Server clustering.

  • Supports JSSE SSL.

  • Faster and more scalable than IIOP clients.

  • All WebLogic client JMS features, including the WebLogic JMS CLient Store-and-Forward (SAF) Service.

  • Supports most of the Java EE features.

  • Supports operations necessary for development purposes, such as the ejbc compiler.

  • Supports administrative operations such as deployment.

  • Supports WLST and client-side JSR 88 applications that invoke server-side operations.

  • See WebLogic Install Client.

Deprecated

WL Full Client (T3)

RMI

Java

T3

wlfullclient.jar (deprecated)

  • Deprecated WebLogic Server 12.1.3.

  • Supports most of the WebLogic Server-specific features

  • Supports WebLogic Server clustering.

  • Faster and more scalable than IIOP clients.

  • Supports most Java EE features.

  • See Developing a WebLogic Full Client (Deprecated).

Deprecated

WLS-IIOP

(Introduced in WebLogic Server 7.0)

RMI

Java

IIOP

wlfullclient.jar (deprecated)

  • Supports WebLogic Server-specific features.

    Deprecated WebLogic Server 12.1.3.

  • Supports WebLogic Server clustering.

  • Faster and more scalable than IIOP thin clients.

  • Not ORB-based.

  • Does not support WebLogic Server JMS (use T3 protocol with same Jar instead).

  • See Developing a WLS-IIOP Client (Deprecated).

Deprecated

Thin Client

RMI

Java

IIOP

wlclient.jar (deprecated)

  • Supports WebLogic Server clustering.

  • Supports many Java EE features, including security and transactions.

  • Supports SSL.

  • Uses CORBA 2.4 ORB.

  • Consider using one of the faster T3 client options.

  • See Developing a Thin Client.

CORBA/IDL

CORBA

Languages that OMG IDL maps to, such as C++, C, Smalltalk, COBOL

IIOP

no WebLogic classes

Java SE

RMI

Java

IIOP

no WebLogic classes

  • Provides connectivity to WebLogic Server environment.

  • Does not support WebLogic Server-specific features. Does not support many Java EE features.

  • Uses CORBA 2.3 ORB.

  • Requires use of com.sun.jndi.cosnaming. CNCtxFactory.

  • Supports clients till JDK 1.8 (Java SE does not embed a CORBA ORB after JDK 1.8.).

  • See Developing a Java SE Client (Deprecated).

Deprecated

JMS Thin Client

RMI

Java

IIOP

wljmsclient.jar

wlclient.jar (deprecated)

  • Thin client functionality

  • WebLogic JMS, except for client-side XML selection for multicast sessions and JMSHelper class methods.

  • Supports SSL.

  • See WebLogic JMS Thin Client (Deprecated).

  • Consider using one of the faster T3 client options.

JMS SAF Client

(Introduced in WebLogic Server 9.2)

RMI

Java

t3 or IIOP

  • wlsaft3client.jar and wlthint3client.jar (preferred) or

  • wlsafclient.jar (deprecated - uses IIOP), wljmsclient.jar (deprecated - uses IIOP), wlclient.jar (deprecated)

JMS C Client

(Introduced in WebLogic Server 9.0)

JNI

C

Any

Any WebLogic JMS capable Java client, such as wlthint3client.jar

  • C client applications that can access WebLogic JMS applications and resources.

  • Supports SSL.

  • See WebLogic JMS C API

JMS .NET Client

(Introduced in WebLogic Server 10.3)

T3

.NET

T3

WebLogic.Messaging.dll dynamic library

WebLogic AQ JMS Client

(Introduced in WebLogic Server 10.3.1)

JNDI/

Java

IIOP/T3 +

aqapi.jar, o6.jar, orai18n.jar and the wlclient.jar (deprecated), wlfullclient.jar (deprecated), weblogic.jar (Install client), or wlthint3client.jar

See Standalone WebLogic AQ JMS Clients in Administering JMS Resources for Oracle WebLogic Server.

JMX

RMI

Java

IIOP

wljmxclient.jar

See Accessing WebLogic Server MBeans with JMX in Developing Custom Management Utilities Using JMX for Oracle WebLogic Server.

Web Services

SOAP

Java

HTTP/S

com.oracle.webservices.wls.jaxws-wlswss-client.jar

com.oracle.webservices.wls.jaxws-owsm-client.jar

com.oracle.webservices.fmw.client.jar

See Invoking a Web Service from a Standalone Java SE Client in Developing JAX-WS Web Services for Oracle WebLogic Server.

C++ Client

CORBA

C++

IIOP

Tuxedo libraries

REST Client

JAX-RS

Java

HTTP

jersey-client.jar

Supports JAX-RS client API.