Channel Entity

Since version 9.0.0, the Java SDK supports entities, which are SDK objects that provide operations on endpoints associated with their type. They are designed as first-class citizens to facilitate working with various PubNub APIs.

Certain PubNub API functionality is already exposed via entities, while other may still be available using the pubnub object.

Create a Channel

This method returns one local Channel entity.

pubnub.channel(String name)
* required
ParameterDescription
name *
Type: String
The name of a single channel to create a channel entity for.

Basic usage

Reference code

This example is a self-contained code snippet ready to be run. It includes necessary imports and executes methods with console logging. Use it as a reference when working with other examples in this document.

import com.pubnub.api.PubNubException;
import com.pubnub.api.java.PubNub;
import com.pubnub.api.java.v2.PNConfiguration;
import com.pubnub.api.UserId;
import com.pubnub.api.enums.PNLogVerbosity;
import com.pubnub.api.java.v2.entities.Channel;

public class ChannelApp {
public static void main(String[] args) throws PubNubException {
// Configure PubNub instance
PNConfiguration.Builder configBuilder = PNConfiguration.builder(new UserId("demoUserId"), "demo");
configBuilder.publishKey("demo");
configBuilder.logVerbosity(PNLogVerbosity.BODY);
configBuilder.secure(true);

show all 23 lines

Available operations

The Channel entity provides operations performed on PubNub channels.

Operation (click for more information)Description
subscription(subscriptionOptions)
Returns a local channel subscription object with optional parameters to which you can subscribe and start receiving real-time updates for that channel.
publish(message, shouldStore, meta, queryParam, usePost, ttl)
Sends a message to all channel subscribers.
fire(message, meta, usePost)
Sends a message to Illuminate and Functions event handlers registered on the channel and trigger their execution.
signal(message, meta, usePost)
Sends a send a signal

Signal

A non-persistent message limited to 64 bytes designed for high-volume usecases where the the most recent data is relevant, like GPS location updates.
to all subscribers of a channel.
Last updated on