org.red5.server.service.ReflectionUtils Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of ant-media-server-common Show documentation
Show all versions of ant-media-server-common Show documentation
Classes common for multiple Ant Media projects
/*
* RED5 Open Source Media Server - https://github.com/Red5/
*
* Copyright 2006-2016 by respective authors (see below). All rights reserved.
*
* 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.red5.server.service;
import java.lang.reflect.Method;
import java.util.ArrayList;
import java.util.List;
import org.red5.io.utils.ConversionUtils;
import org.red5.server.api.IConnection;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
/**
* Provides a means for locating methods within service classes using reflection.
*/
public class ReflectionUtils {
private static final Logger log = LoggerFactory.getLogger(ReflectionUtils.class);
//used to prevent extra object creation when a method with a set of params is not found
private static final Object[] nullReturn = new Object[] { null, null };
/**
* Returns (method, params) for the given service or (null, null) if no method was found.
*
* @param service
* Service
* @param methodName
* Method name
* @param args
* Arguments
* @return Method/params pairs
*/
public static Object[] findMethodWithExactParameters(Object service, String methodName, List args) {
Object[] arguments = new Object[args.size()];
for (int i = 0; i < args.size(); i++) {
arguments[i] = args.get(i);
}
return findMethodWithExactParameters(service, methodName, arguments);
}
/**
* Returns (method, params) for the given service or (null, null) if not method was found. XXX use ranking for method matching rather
* than exact type matching plus type conversion.
*
* @param service
* Service
* @param methodName
* Method name
* @param args
* Arguments
* @return Method/params pairs
*/
public static Object[] findMethodWithExactParameters(Object service, String methodName, Object[] args) {
int numParams = (args == null) ? 0 : args.length;
log.trace("Args / parameters count: {}", numParams);
Method method = null;
// convert the args first
Object[] params = ConversionUtils.convertParams(args);
if (log.isDebugEnabled()) {
for (Object clazz : params) {
log.debug("Parameter: {}", clazz);
}
}
// try to skip the listing of all the methods by checking for exactly what we want first
try {
method = service.getClass().getMethod(methodName, (Class[]) params);
log.debug("Exact method found, skipping list: {}", methodName);
return new Object[] { method, args };
} catch (NoSuchMethodException nsme) {
log.debug("Method not found using exact parameter types");
}
List methods = ConversionUtils.findMethodsByNameAndNumParams(service, methodName, numParams);
log.debug("Found {} methods", methods.size());
if (methods.isEmpty()) {
return new Object[] { null, null };
} else if (methods.size() == 1 && args == null) {
return new Object[] { methods.get(0), null };
} else if (methods.size() > 1) {
log.debug("Multiple methods found with same name and parameter count; parameter conversion will be attempted in order.");
}
// search for method with exact parameters
for (int i = 0; i < methods.size(); i++) {
method = methods.get(i);
boolean valid = true;
Class[] paramTypes = method.getParameterTypes();
for (int j = 0; j < args.length; j++) {
if ((args[j] == null && paramTypes[j].isPrimitive()) || (args[j] != null && !args[j].getClass().equals(paramTypes[j]))) {
valid = false;
break;
}
}
if (valid) {
return new Object[] { method, args };
}
}
// try to convert parameters
for (int i = 0; i < methods.size(); i++) {
try {
method = methods.get(i);
params = ConversionUtils.convertParams(args, method.getParameterTypes());
if (args.length > 0 && (args[0] instanceof IConnection) && (!(params[0] instanceof IConnection))) {
// don't convert first IConnection parameter
continue;
}
return new Object[] { method, params };
} catch (Exception ex) {
log.debug("Parameter conversion failed for {}", method);
}
}
return new Object[] { null, null };
}
/**
* Returns (method, params) for the given service or (null, null) if no method was found.
*
* @param service
* Service
* @param methodName
* Method name
* @param args
* Arguments
* @return Method/params pairs
*/
public static Object[] findMethodWithListParameters(Object service, String methodName, List args) {
Object[] arguments = new Object[args.size()];
for (int i = 0; i < args.size(); i++) {
arguments[i] = args.get(i);
}
return findMethodWithListParameters(service, methodName, arguments);
}
/**
* Returns (method, params) for the given service or (null, null) if not method was found.
*
* @param service
* Service
* @param methodName
* Method name
* @param args
* Arguments
* @return Method/params pairs
*/
public static Object[] findMethodWithListParameters(Object service, String methodName, Object[] args) {
Method method = null;
try {
//try to skip the listing of all the methods by checking for exactly what
//we want first
method = service.getClass().getMethod(methodName, ConversionUtils.convertParams(args));
log.debug("Exact method found (skipping list): {}", methodName);
return new Object[] { method, args };
} catch (NoSuchMethodException nsme) {
log.debug("Method not found using exact parameter types");
}
List methods = ConversionUtils.findMethodsByNameAndNumParams(service, methodName, 1);
log.debug("Found {} methods", methods.size());
if (methods.isEmpty()) {
return new Object[] { null, null };
} else if (methods.size() > 1) {
log.debug("Multiple methods found with same name and parameter count; parameter conversion will be attempted in order.");
}
ArrayList