org.bridje.ioc.thls.Thls Maven / Gradle / Ivy

Show more of this group Show more artifacts with this name
Show all versions of bridje-ioc Show documentation
Bridje Inversion of Control API
There is a newer version: 0.6.4
/*
 * Copyright 2015 Bridje 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.
 */

package org.bridje.ioc.thls;

import org.bridje.ioc.Ioc;

/**
 * Facade to thread local storage (ThLS) service. {@link ThlsService}
 */
public class Thls
{
    private static ThlsService thlsServ;

    /**
     * Get the last object of the cls Class that was put in the thread local
     * storage.
     *
     * @param  The type of the object to look for.
     * @param cls The class of the object to look for.
     *
     * @return The last object of the specified class that was put in the thread
     *         local storage, or null if none can be found.
     */
    public static  T get(Class cls)
    {
        if (thlsServ == null)
        {
            thlsServ = Ioc.context().find(ThlsService.class);
        }
        return thlsServ.get(cls);
    }

    /**
     * This method puts all the data objects on the internal thread local
     * storage an executes the {@link ThlsAction}.
     *
     * @param     The type of the resulting object for the action.
     * @param     The type of the data to be put in the thread.
     * @param action The action to be executed.
     * @param cls    The class of the data to be put in the thread.
     * @param data   The data that must be available for the action.
     *
     * @return The object returned by the {@link ThlsAction#execute()} method.
     */
    public static  T doAs(ThlsAction action, Class cls, D data)
    {
        if (thlsServ == null)
        {
            thlsServ = Ioc.context().find(ThlsService.class);
        }
        return thlsServ.doAs(action, cls, data);
    }

    /**
     * This method puts all the data objects on the internal thread local
     * storage an executes the {@link ThlsAction}.
     *
     * @param     The type of the resulting object for the action.
     * @param     The type of the data to be put in the thread.
     * @param     The type of the first exception throw by the execution of
     *               this action.
     * @param action The action to be executed.
     * @param cls    The class of the data to be put in the thread.
     * @param data   The data that must be available for the action.
     *
     * @return The object returned by the {@link ThlsActionException#execute()}
     *         method.
     *
     * @throws E Exception throw by the action.
     */
    public static  T doAsEx(ThlsActionException action, Class cls, D data) throws E
    {
        if (thlsServ == null)
        {
            thlsServ = Ioc.context().find(ThlsService.class);
        }
        return thlsServ.doAsEx(action, cls, data);
    }

    /**
     * This method puts all the data objects on the internal thread local
     * storage an executes the {@link ThlsAction}.
     *
     * @param     The type of the resulting object for the action.
     * @param     The type of the data to be put in the thread.
     * @param     The type of the first exception throw by the execution of
     *               this action.
     * @param    The type of the second exception throw by the execution of
     *               this action.
     * @param action The action to be executed.
     * @param cls    The class of the data to be put in the thread.
     * @param data   The data that must be available for the action.
     *
     * @return The object returned by the {@link ThlsActionException2#execute()}
     *         method.
     *
     * @throws E  Exception throw by the action.
     * @throws E2 The second exception throw by the action.
     */
    public static  T doAsEx2(ThlsActionException2 action, Class cls, D data) throws E, E2
    {
        if (thlsServ == null)
        {
            thlsServ = Ioc.context().find(ThlsService.class);
        }
        return thlsServ.doAsEx2(action, cls, data);
    }

}