001/* 002 * Licensed to the Apache Software Foundation (ASF) under one or more 003 * contributor license agreements. See the NOTICE file distributed with 004 * this work for additional information regarding copyright ownership. 005 * The ASF licenses this file to You under the Apache License, Version 2.0 006 * (the "License"); you may not use this file except in compliance with 007 * the License. You may obtain a copy of the License at 008 * 009 * http://www.apache.org/licenses/LICENSE-2.0 010 * 011 * Unless required by applicable law or agreed to in writing, software 012 * distributed under the License is distributed on an "AS IS" BASIS, 013 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 014 * See the License for the specific language governing permissions and 015 * limitations under the License. 016 */ 017 018package org.apache.commons.proxy2.interceptor.matcher.invocation; 019 020import org.apache.commons.proxy2.Invocation; 021import org.apache.commons.proxy2.interceptor.matcher.InvocationMatcher; 022 023/** 024 * InvocationMatcher based on declaring class of the method invoked. 025 */ 026public class DeclaredByMatcher implements InvocationMatcher 027{ 028 //****************************************************************************************************************** 029 // Fields 030 //****************************************************************************************************************** 031 032 private final boolean exactMatch; 033 private final Class<?> declaredByType; 034 035 //****************************************************************************************************************** 036 // Constructors 037 //****************************************************************************************************************** 038 039 /** 040 * Equivalent to {@link #DeclaredByMatcher(Class, boolean)}{@code (declaredByType, false)} 041 * 042 * @param declaredByType 043 */ 044 public DeclaredByMatcher(Class<?> declaredByType) 045 { 046 this(declaredByType, false); 047 } 048 049 /** 050 * Create a {@link DeclaredByMatcher} instance. 051 * 052 * @param declaredByType 053 * type by which method must be declared 054 * @param exactMatch 055 * if {@code false}, {@code declaredByType} may be a subclass of the actual declaring class of the 056 * invocation method. 057 */ 058 public DeclaredByMatcher(Class<?> declaredByType, boolean exactMatch) 059 { 060 this.declaredByType = declaredByType; 061 this.exactMatch = exactMatch; 062 } 063 064 //****************************************************************************************************************** 065 // InvocationMatcher Implementation 066 //****************************************************************************************************************** 067 068 @Override 069 public boolean matches(Invocation invocation) 070 { 071 final Class<?> owner = invocation.getMethod().getDeclaringClass(); 072 return exactMatch ? declaredByType.equals(owner) : owner.isAssignableFrom(declaredByType); 073 } 074}