attila@963: /* attila@963: * Copyright (c) 2010, 2013, Oracle and/or its affiliates. All rights reserved. attila@963: * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. attila@963: * attila@963: * This code is free software; you can redistribute it and/or modify it attila@963: * under the terms of the GNU General Public License version 2 only, as attila@963: * published by the Free Software Foundation. Oracle designates this attila@963: * particular file as subject to the "Classpath" exception as provided attila@963: * by Oracle in the LICENSE file that accompanied this code. attila@963: * attila@963: * This code is distributed in the hope that it will be useful, but WITHOUT attila@963: * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or attila@963: * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License attila@963: * version 2 for more details (a copy is included in the LICENSE file that attila@963: * accompanied this code). attila@963: * attila@963: * You should have received a copy of the GNU General Public License version attila@963: * 2 along with this work; if not, write to the Free Software Foundation, attila@963: * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. attila@963: * attila@963: * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA attila@963: * or visit www.oracle.com if you need additional information or have any attila@963: * questions. attila@963: */ attila@963: attila@963: /* attila@963: * This file is available under and governed by the GNU General Public attila@963: * License version 2 only, as published by the Free Software Foundation. attila@963: * However, the following notice accompanied the original version of this attila@963: * file, and Oracle licenses the original version of this file under the BSD attila@963: * license: attila@963: */ attila@963: /* attila@963: Copyright 2009-2013 Attila Szegedi attila@963: attila@963: Licensed under both the Apache License, Version 2.0 (the "Apache License") attila@963: and the BSD License (the "BSD License"), with licensee being free to attila@963: choose either of the two at their discretion. attila@963: attila@963: You may not use this file except in compliance with either the Apache attila@963: License or the BSD License. attila@963: attila@963: If you choose to use this file in compliance with the Apache License, the attila@963: following notice applies to you: attila@963: attila@963: You may obtain a copy of the Apache License at attila@963: attila@963: http://www.apache.org/licenses/LICENSE-2.0 attila@963: attila@963: Unless required by applicable law or agreed to in writing, software attila@963: distributed under the License is distributed on an "AS IS" BASIS, attila@963: WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or attila@963: implied. See the License for the specific language governing attila@963: permissions and limitations under the License. attila@963: attila@963: If you choose to use this file in compliance with the BSD License, the attila@963: following notice applies to you: attila@963: attila@963: Redistribution and use in source and binary forms, with or without attila@963: modification, are permitted provided that the following conditions are attila@963: met: attila@963: * Redistributions of source code must retain the above copyright attila@963: notice, this list of conditions and the following disclaimer. attila@963: * Redistributions in binary form must reproduce the above copyright attila@963: notice, this list of conditions and the following disclaimer in the attila@963: documentation and/or other materials provided with the distribution. attila@963: * Neither the name of the copyright holder nor the names of attila@963: contributors may be used to endorse or promote products derived from attila@963: this software without specific prior written permission. attila@963: attila@963: THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS attila@963: IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED attila@963: TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A attila@963: PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL COPYRIGHT HOLDER attila@963: BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR attila@963: CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF attila@963: SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR attila@963: BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, attila@963: WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR attila@963: OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF attila@963: ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. attila@963: */ attila@963: attila@963: package jdk.internal.dynalink; attila@963: attila@963: import jdk.internal.dynalink.linker.GuardedInvocation; attila@963: import jdk.internal.dynalink.linker.LinkRequest; attila@963: import jdk.internal.dynalink.linker.LinkerServices; attila@963: attila@963: /** attila@963: * Interface for objects that are used to transform one guarded invocation into another one. Typical usage is for attila@963: * implementing {@link DynamicLinkerFactory#setPrelinkFilter(GuardedInvocationFilter) pre-link filters}. attila@963: */ attila@963: public interface GuardedInvocationFilter { attila@963: /** attila@963: * Given a guarded invocation, return a potentially different guarded invocation. attila@963: * @param inv the original guarded invocation. Null is never passed. attila@963: * @param linkRequest the link request for which the invocation was generated (usually by some linker). attila@963: * @param linkerServices the linker services that can be used during creation of a new invocation. attila@963: * @return either the passed guarded invocation or a different one, with the difference usually determined based on attila@963: * information in the link request and the differing invocation created with the assistance of the linker services. attila@963: * Whether or not {@code null} is an accepted return value is dependent on the user of the filter. attila@963: */ attila@963: public GuardedInvocation filter(GuardedInvocation inv, LinkRequest linkRequest, LinkerServices linkerServices); attila@963: }