001/* 002 * BridJ - Dynamic and blazing-fast native interop for Java. 003 * http://bridj.googlecode.com/ 004 * 005 * Copyright (c) 2010-2013, Olivier Chafik (http://ochafik.com/) 006 * All rights reserved. 007 * 008 * Redistribution and use in source and binary forms, with or without 009 * modification, are permitted provided that the following conditions are met: 010 * 011 * * Redistributions of source code must retain the above copyright 012 * notice, this list of conditions and the following disclaimer. 013 * * Redistributions in binary form must reproduce the above copyright 014 * notice, this list of conditions and the following disclaimer in the 015 * documentation and/or other materials provided with the distribution. 016 * * Neither the name of Olivier Chafik nor the 017 * names of its contributors may be used to endorse or promote products 018 * derived from this software without specific prior written permission. 019 * 020 * THIS SOFTWARE IS PROVIDED BY OLIVIER CHAFIK AND CONTRIBUTORS ``AS IS'' AND ANY 021 * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED 022 * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE 023 * DISCLAIMED. IN NO EVENT SHALL THE REGENTS AND CONTRIBUTORS BE LIABLE FOR ANY 024 * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES 025 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; 026 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND 027 * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 028 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS 029 * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 030 */ 031package org.bridj.ann; 032 033import java.lang.annotation.ElementType; 034import java.lang.annotation.Inherited; 035import java.lang.annotation.Retention; 036import java.lang.annotation.RetentionPolicy; 037import java.lang.annotation.Target; 038 039/** 040 * Specify the name of the native library that should be bound to the class or 041 * method this annotation is put on.<br> 042 * This name can then be changed at runtime to match the platform-specific name 043 * of the library with 044 * {@link org.bridj.BridJ#setNativeLibraryActualName(String, String)}. 045 * <p> 046 * Alternative aliases can also be added at runtime with 047 * {@link org.bridj.BridJ#addNativeLibraryAlias(String, String)}. 048 * <p> 049 * Finally, dependencies can also be added at runtime with 050 * {@link org.bridj.BridJ#addNativeLibraryDependencies(java.lang.String, java.lang.String...)}. 051 * 052 * @author Olivier Chafik 053 */ 054@Retention(RetentionPolicy.RUNTIME) 055@Inherited 056@Target({ElementType.TYPE, ElementType.METHOD, ElementType.CONSTRUCTOR}) 057public @interface Library { 058 059 /** 060 * Name of this library. 061 */ 062 String value(); 063 064 /** 065 * Names of libraries that need to be loaded before this library is loaded 066 */ 067 String[] dependencies() default {}; 068 069 String versionPattern() default ""; 070}