org.kurento.client.AbstractBuilder Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of kurento-client Show documentation
Kurento Client The Kurento Client project allows server applications to control media server resources.
There is a newer version: 7.1.0
/*
 * (C) Copyright 2016 Kurento (http://kurento.org/)
 *
 * 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 org.kurento.client;

import org.kurento.client.internal.client.DefaultContinuation;
import org.kurento.client.internal.client.RemoteObject;
import org.kurento.client.internal.client.RemoteObjectInvocationHandler;
import org.kurento.client.internal.client.RomManager;
import org.kurento.jsonrpc.Props;

/**
 * Kurento Media Builder base interface. Builds a {@code } object, either synchronously using
 * {@link #build} or asynchronously using {@link #buildAsync}
 *
 * @param T
 *          the type of object to build
 *
 **/
public class AbstractBuilder {

  protected final Props props;
  protected final Props genericProperties = new Props();
  private final RomManager manager;
  private final Class clazz;

  public AbstractBuilder(Class clazz, KurentoObject kurentoObject) {

    this.props = new Props();
    this.clazz = clazz;
    this.manager = RemoteObjectInvocationHandler.getFor(kurentoObject).getRomManager();
  }

  public AbstractBuilder(Class clazz, RomManager manager) {

    this.props = new Props();
    this.clazz = clazz;
    this.manager = manager;
  }

  /**
   * Builds an object synchronously using the builder design pattern.
   *
   * @return T The type of object
   *
   **/
  @SuppressWarnings("unchecked")
  public T build() {

    RemoteObject remoteObject = manager.createWithKurentoObject(clazz, props, genericProperties);

    return (T) remoteObject.getKurentoObject();

  }

  @SuppressWarnings("unchecked")
  public T build(Transaction transaction) {

    RemoteObject remoteObject = manager.createWithKurentoObject(clazz, props, genericProperties,
        transaction);

    return (T) remoteObject.getKurentoObject();
  }

  /**
   * Builds an object asynchronously using the builder design pattern.
   * 
   * The continuation will have {@link Continuation#onSuccess} called when the object is ready, or
   * {@link Continuation#onError} if an error occurs
   *
   * @param continuation
   *          will be called when the object is built
   *
   *
   **/
  public void buildAsync(final Continuation continuation) {

    manager.create(clazz.getSimpleName(), props, genericProperties,
        new DefaultContinuation(continuation) {
          @SuppressWarnings("unchecked")
          @Override
          public void onSuccess(RemoteObject remoteObject) {
            try {
              continuation.onSuccess(
                  (T) RemoteObjectInvocationHandler.newProxy(remoteObject, manager, clazz));
            } catch (Exception e) {
              log.warn("[Continuation] error invoking onSuccess implemented by client", e);
            }
          }
        });

  }

  public AbstractBuilder withProperties(Properties properties) {
    genericProperties.getMap().putAll(properties.getMap());
    return this;
  }

  public AbstractBuilder with(String name, Object value) {
    genericProperties.add(name, value);
    return this;
  }

}