KillbillApiAopModule.java

/*
 * Copyright 2014-2018 Groupon, Inc
 * Copyright 2014-2018 The Billing Project, LLC
 *
 * The Billing Project licenses this file to you 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.killbill.billing.util.glue;

import java.lang.reflect.Method;

import org.aopalliance.intercept.MethodInterceptor;
import org.aopalliance.intercept.MethodInvocation;
import org.killbill.billing.KillbillApi;
import org.killbill.billing.osgi.api.ROTenantContext;
import org.killbill.billing.util.callcontext.CallContext;
import org.killbill.billing.util.entity.dao.DBRouterUntyped;
import org.killbill.commons.profiling.Profiling;
import org.killbill.commons.profiling.Profiling.WithProfilingCallback;
import org.killbill.commons.profiling.ProfilingFeature.ProfilingFeatureType;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

import com.google.inject.AbstractModule;
import com.google.inject.matcher.Matcher;
import com.google.inject.matcher.Matchers;

public class KillbillApiAopModule extends AbstractModule {

    private static final Logger logger = LoggerFactory.getLogger(KillbillApiAopModule.class);

    private static final Matcher<Method> SYNTHETIC_METHOD_MATCHER = new Matcher<Method>() {
        @Override
        public boolean matches(final Method method) {
            return method.isSynthetic();
        }

        @Override
        public Matcher<Method> and(final Matcher<? super Method> other) {
            throw new UnsupportedOperationException();
        }

        @Override
        public Matcher<Method> or(final Matcher<? super Method> other) {
            throw new UnsupportedOperationException();
        }
    };

    @Override
    protected void configure() {
        bindInterceptor(Matchers.subclassesOf(KillbillApi.class),
                        Matchers.not(SYNTHETIC_METHOD_MATCHER),
                        new ProfilingMethodInterceptor());
    }

    public static class ProfilingMethodInterceptor implements MethodInterceptor {

        private final Profiling<Object, Throwable> prof = new Profiling<Object, Throwable>();

        @Override
        public Object invoke(final MethodInvocation invocation) throws Throwable {
            final WithProfilingCallback<Object, Throwable> callback = new WithProfilingCallback<Object, Throwable>() {
                @Override
                public Object execute() throws Throwable {
                    logger.debug("Entering API call {}, arguments: {}", invocation.getMethod(), invocation.getArguments());
                    final Object proceed = invocation.proceed();
                    logger.debug("Exiting  API call {}, returning: {}", invocation.getMethod(), proceed);
                    return proceed;
                }
            };

            if (forcedRODBI(invocation)) {
                return prof.executeWithProfiling(ProfilingFeatureType.API,
                                                 invocation.getMethod().getName(),
                                                 new WithProfilingCallback<Object, Throwable>() {
                                                     @Override
                                                     public Object execute() throws Throwable {
                                                         return DBRouterUntyped.withRODBIAllowed(true, callback);
                                                     }
                                                 });
            } else {
                return prof.executeWithProfiling(ProfilingFeatureType.API,
                                                 invocation.getMethod().getName(),
                                                 callback);
            }
        }

        private boolean forcedRODBI(final MethodInvocation invocation) {
            // Snowflakes from server filters
            final boolean safeROOperations = "getTenantByApiKey".equals(invocation.getMethod().getName()) || "login".equals(invocation.getMethod().getName());
            if (safeROOperations) {
                return true;
            }

            final Object[] arguments = invocation.getArguments();
            if (arguments.length == 0) {
                return false;
            }

            for (int i = arguments.length - 1; i >= 0; i--) {
                final Object argument = arguments[i];
                // RO DB explicitly requested by a plugin
                final boolean pluginRequestROInstance = argument instanceof ROTenantContext && !(argument instanceof CallContext);
                if (pluginRequestROInstance) {
                    return true;
                }
            }

            return false;
        }
    }
}