org.fujion.client.ClientInvocation Maven / Gradle / Ivy
/*
* #%L
* fujion
* %%
* Copyright (C) 2018 Fujion Framework
* %%
* 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.
*
* #L%
*/
package org.fujion.client;
import java.util.Collection;
import java.util.Date;
import java.util.HashMap;
import java.util.Map;
import org.fujion.ancillary.IElementIdentifier;
import org.fujion.ancillary.IResponseCallback;
import org.fujion.ancillary.OptionMap;
import org.fujion.component.Page;
import org.springframework.util.ClassUtils;
/**
* Represents a function invocation request to be sent to the client.
*/
public class ClientInvocation {
private final String function;
private final IElementIdentifier target;
private final IResponseCallback callback;
private final Object[] arguments;
private final String key;
/**
* Create a client invocation request.
*
* @param function A fully qualified path to a free-standing function. This may be one of the
* following formats:
*
*
* [key]^[function name]
* - The key and the function name are explicitly declared.
*
*
* ^[function name]
* - The key is implied to be the same as the function name.
*
*
* [function name]
* - The key will default to a unique value.
*
*
* @param callback Optional callback for results.
* @param arguments Optional arguments to be passed to the function.
*/
public ClientInvocation(String function, IResponseCallback callback, Object... arguments) {
this((IElementIdentifier) null, function, callback, arguments);
}
/**
* Create a client invocation request.
*
* @param target The identifier of the widget that implements the function being invoked. If
* null is specified, the function name must specify a fully qualified path to a
* free-standing function.
* @param function The name of the function to be invoked. This may be one of the following
* formats:
*
*
* [key]^[function name]
* - The key and the function name are explicitly declared.
*
*
* ^[function name]
* - The key is implied to be the same as the function name.
*
*
* [function name]
* - The key will default to a unique value.
*
*
* @param callback Optional callback for results.
* @param arguments Optional arguments to be passed to the function.
*/
public ClientInvocation(IElementIdentifier target, String function, IResponseCallback callback, Object... arguments) {
this.target = target;
this.arguments = arguments;
this.callback = callback;
String[] pcs = function.split("\\^", 2);
this.function = pcs.length == 1 ? pcs[0] : pcs[1];
this.key = pcs.length == 1 ? null : pcs[0].isEmpty() ? pcs[1] : pcs[0];
}
/**
* Create a client invocation request.
*
* @param moduleName The name of the module whose exported function is to be invoked. If null is
* specified, the function name must specify a fully qualified path to a
* free-standing function.
* @param function The name of the exported function to be invoked. This may be one of the
* following formats:
*
*
* [key]^[function name]
* - The key and the function name are explicitly declared.
*
*
* ^[function name]
* - The key is implied to be the same as the function name.
*
*
* [function name]
* - The key will default to a unique value.
*
*
* @param callback Optional callback for results.
* @param arguments Optional arguments to be passed to the function.
*/
public ClientInvocation(String moduleName, String function, IResponseCallback callback, Object... arguments) {
this(moduleName == null ? null : () -> "@" + moduleName, function, callback, arguments);
}
/**
* Returns the key associated with the client invocation request. This key is used when queuing
* the request. If a client invocation request with a matching key already exists in the queue,
* it will be replaced by this one.
*
* @return The key of the client invocation request.
*/
public String getKey() {
return key == null ? "" + hashCode() : target == null ? key : key + "^" + target.hashCode();
}
/**
* Packages the client invocation request as a map for serialization and transport.
*
* @param page The page that is the target of the invocation.
* @return Client invocation request as a map.
*/
public OptionMap toMap(Page page) {
OptionMap data = new OptionMap();
data.put("fcn", function);
data.put("tgt", target == null ? null : target.getId());
data.put("arg", transformArray(arguments, false));
data.put("cbk", callback == null ? null : page.registerCallback(callback));
return data;
}
/**
* Transforms a component or subcomponent by replacing it with its selector. This only effects
* IElementIdentifier implementations. All other source objects are returned unchanged.
*
* @param source The source object.
* @return The original or transformed object.
*/
@SuppressWarnings("unchecked")
private Object transform(Object source) {
while (source instanceof IClientTransform) {
source = ((IClientTransform) source).transformForClient();
}
if (source == null || ignore(source.getClass())) {
return source;
}
if (source.getClass().isEnum()) {
return source.toString();
}
if (source.getClass().isArray()) {
return transformArray((Object[]) source, true);
}
if (source instanceof Map) {
return transformMap((Map) source);
}
if (source instanceof Collection) {
return transformArray(((Collection © 2015 - 2025 Weber Informatics LLC | Privacy Policy