1、American National StandardDeveloped byfor Information Technology Biometric ApplicationProgramming Interface Java(BioAPI Java)INCITS 474-2011INCITS 474-2011Provided by IHSNot for ResaleNo reproduction or networking permitted without license from IHS-,-,-Provided by IHSNot for ResaleNo reproduction or
2、 networking permitted without license from IHS-,-,-INCITS 474-2011American National Standardfor Information Technology Biometric ApplicationProgramming Interface Java(BioAPI Java)SecretariatInformation Technology Industry CouncilApproved October 5, 2011American National Standards Institute, Inc.Prov
3、ided by IHSNot for ResaleNo reproduction or networking permitted without license from IHS-,-,-Approval of an American National Standard requires review by ANSI that therequirements for due process, consensus, and other criteria for approval havebeen met by the standards developer.Consensus is establ
4、ished when, in the judgement of the ANSI Board ofStandards Review, substantial agreement has been reached by directly andmaterially affected interests. Substantial agreement means much more thana simple majority, but not necessarily unanimity. Consensus requires that allviews and objections be consi
5、dered, and that a concerted effort be madetowards their resolution.The use of American National Standards is completely voluntary; theirexistence does not in any respect preclude anyone, whether he has approvedthe standards or not, from manufacturing, marketing, purchasing, or usingproducts, process
6、es, or procedures not conforming to the standards.The American National Standards Institute does not develop standards andwill in no circumstances give an interpretation of any American NationalStandard. Moreover, no person shall have the right or authority to issue aninterpretation of an American N
7、ational Standard in the name of the AmericanNational Standards Institute. Requests for interpretations should beaddressed to the secretariat or sponsor whose name appears on the titlepage of this standard.CAUTION NOTICE: This American National Standard may be revised orwithdrawn at any time. The pro
8、cedures of the American National StandardsInstitute require that action be taken periodically to reaffirm, revise, orwithdraw this standard. Purchasers of American National Standards mayreceive current information on all standards by calling or writing the AmericanNational Standards Institute.Americ
9、an National StandardPublished byAmerican National Standards Institute, Inc.25 West 43rd Street, New York, NY 10036Copyright 2011 by Information Technology Industry Council (ITI)All rights reserved.No part of this publication may be reproduced in anyform, in an electronic retrieval system or otherwis
10、e,without prior written permission of ITI, 1101 K Street NW, Suite 610, Washington, DC 20005. Printed in the United States of AmericaCAUTION: The developers of this standard have requested that holders of patents that may berequired for the implementation of the standard disclose such patents to the
11、 publisher. However,neither the developers nor the publisher have undertaken a patent search in order to identifywhich, if any, patents may apply to this standard. As of the date of publication of this standardand following calls for the identification of patents that may be required for the impleme
12、ntation ofthe standard, no such claims have been made. No further patent search is conducted by the de-veloper or publisher in respect to any standard it processes. No representation is made or impliedthat licenses are not required to avoid infringement in the use of this standard.Provided by IHSNot
13、 for ResaleNo reproduction or networking permitted without license from IHS-,-,-iContentsPageForeword .ivIntroduction . viii1 Scope. 12 Conformance . 13 Normative References . 14 Terms and Definitions 25 Symbols and Abbreviated Terms. 86 BioAPI Java Package Structure. 86.1 package org.bioapi. 86.1.1
14、 Interface org.bioapi.Archive . 86.1.2 Interface org.bioapi.AttachSession 96.1.3 Enum org.bioapi.AttachSession.EnrollResult extends Processing.CreateTemplateResult. 156.1.4 Interface org.bioapi.AttachSession.VerifyResult extends Matching.VerifyResult 166.1.5 Interface org.bioapi.AttachSession.Identi
15、fyResult extends AttachSession.IdentifyResult 166.1.6 class org.bioapi.BioAPIException extends java.lang.Exception 176.1.7 Enum org.bioapi.BioAPIException.Facility extends java.lang.Enum . 206.1.8 Interface org.bioapi.BIRDatabase 206.1.9 Enum org.bioapi.BIRDatabase.Access extends java.lang.Enum 236.
16、1.10 Interface org.bioapi.BIRDatabase.Record . 236.1.11 Interface org.bioapi.BIRDatabase.Marker extends java.util.Iterator 246.1.12 Interface org.bioapi.BSP 246.1.13 Interface org.bioapi.BSP.UnitSet . 276.1.14 Interface org.bioapi.ComponentRegistry . 296.1.15 Interface org.bioapi.Unit. 316.1.16 Enum
17、 org.bioapi.Unit.Category extends java.lang.Enum 326.1.17 Enum org.bioapi.Unit.IndicatorStatus extends java.lang.Enum. 326.1.18 Enum org.bioapi.Unit.PowerMode extends java.lang.Enum 336.1.19 Interface org.bioapi.EventHandler . 336.1.20 Interface org.bioapi.Framework . 336.1.21 class org.bioapi.Frame
18、workFactory extends java.lang.Object. 376.1.22 Interface org.bioapi.GUIImageObserver 376.1.23 Interface org.bioapi.GUIImageObserver.Bitmap 386.1.24 Interface org.bioapi.GUIStateObserver 386.1.25 Enum org.bioapi.GUIStateObserver.Response extends java.lang.Enum . 396.1.26 Interface org.bioapi.GUIState
19、Observer.State 396.1.27 Interface org.bioapi.Matching. 406.1.28 Interface org.bioapi.Matching.IdentifyResult 436.1.29 Interface org.bioapi.Matching.VerifyResult 436.1.30 Enum org.bioapi.Matching.VerifyResult.Options extends java.lang.Enum. 456.1.31 Interface org.bioapi.Processing . 456.1.32 Interfac
20、e org.bioapi.Processing.ProcessResult . 47Provided by IHSNot for ResaleNo reproduction or networking permitted without license from IHS-,-,-iiPage6.1.33 Interface org.bioapi.Processing.CreateTemplateResult 476.1.34 Interface org.bioapi.Query . 486.1.35 Interface org.bioapi.Sensor 486.1.36 Interface
21、org.bioapi.Sensor.CaptureResult 506.1.37 Enum org.bioapi.Sensor.CaptureResult.Options extends java.lang.Enum 506.2 Package org.bioapi.data 506.2.1 Interface org.bioapi.data.BFPSchema. 506.2.2 interface org.bioapi.data.BIR . 516.2.3 Enum org.bioapi.data.BIR.Purpose extends java.lang.Enum 536.2.4 Enum
22、 org.bioapi.data.BIR.Subtype extends java.lang.Enum 536.2.5 Enum org.bioapi.data.BIR.ProcessedLevel . 546.2.6 Enum org.bioapi.data.BIR.BiometricType extends java.lang.Enum 546.2.7 Interface org.bioapi.data.BIR.OwnerTypePair . 546.2.8 Interface org.bioapi.data.BIR.DTG 556.2.9 Interface org.bioapi.dat
23、a.BIR.Format extends BIR.OwnerTypePair . 556.2.10 Interface org.bioapi.data.BIR.SecurityBlockFormat extends BIR.OwnerTypePair . 556.2.11 Interface org.bioapi.data.BIR.ProductID extends BIR.OwnerTypePair . 556.2.12 Interface org.bioapi.data.BIR.Quality. 556.2.13 Interface org.bioapi.data.BSPSchema. 5
24、56.2.14 Interface org.bioapi.data.BSPSchema.Operations 566.2.15 Enum org.bioapi.data.BSPSchema.Operations.Operation extends java.lang.Enum 576.2.16 Interface org.bioapi.data.BSPSchema.Options . 586.2.17 Enum org.bioapi.data.BSPSchema.Options.Option extends java.lang.Enum 596.2.18 Interface org.bioap
25、i.data.Candidates. 596.2.19 Interface org.bioapi.data.Candidates.Candidate . 606.2.20 Interface org.bioapi.data.DataFactory . 606.2.21 Interface org.bioapi.data.Date . 626.2.22 Interface org.bioapi.data.Event 626.2.23 Enum org.bioapi.data.Event.Kind extends java.lang.Enum. 626.2.24 Interface org.bio
26、api.data.FMR . 636.2.25 Interface org.bioapi.data.FrameworkSchema 636.2.26 Interface org.bioapi.data.IdentifyPopulation 636.2.27 Interface org.bioapi.data.Payload 646.2.28 Interface org.bioapi.data.Time . 646.2.29 Interface org.bioapi.data.UnitSchema . 646.3 Package 656.3.1 class .IRI 65Provided by
27、 IHSNot for ResaleNo reproduction or networking permitted without license from IHS-,-,-iiiPageAnnexesA Conformance Requirements 66B Package org.bioapi.template 81C Architecture and Sample Code 86D Mapping of BioAPI 2.0 to BioAPI Java. 87E Java Requirements 90Provided by IHSNot for ResaleNo reproduct
28、ion or networking permitted without license from IHS-,-,-ivForeword (This foreword is not part of American National Standard INCITS 474-2011.)INCITS (The InterNational Committee for Information Technology Standards) is theANSI-recognized Standards Development Organization for information technologyw
29、ithin the United States of America. Members of INCITS are drawn from Govern-ment, Corporations, Academia and other organizations with a material interest in thework of INCITS and its Technical Committees. INCITS does not restrict membershipand attracts participants in its technical work from 13 diff
30、erent countries, and oper-ates under the rules of the American National Standards Institute.In the field of Biometrics, INCITS has established Technical Committee M1. Stan-dards developed by this Technical Committee have reached consensus throughoutthe development process and have been thoroughly re
31、viewed through several publicreview processes. In addition, the INCITS Executive Board and the ANSI Board ofStandards Review have approved this American National Standard for publication asan INCITS Standard.This standard contains five annexes. Annex A is normative and is considered part ofthe stand
32、ard. Annexes B through E are informative and are not considered part of thestandard.Requests for interpretation, suggestions for improvement or addenda, or defect re-ports are welcome. They should be sent to InterNational Committee for InformationTechnology Standards (INCITS), ITI, 1101 K Street, NW
33、, Suite 610, Washington, DC20005.This standard was processed and approved for submittal to ANSI by INCITS. Com-mittee approval of this standard does not necessarily imply that all committee mem-bers voted for its approval. At the time it approved this standard, INCITS had thefollowing members:Don Wr
34、ight, ChairJennifer Garner, SecretaryOrganization Represented Name of RepresentativeAdobe Systems, Inc. Scott Foshee Steve Zilles (Alt.)AIM Global, Inc. . Steve HallidayApple Computer, Inc. . Kwok Lau Helene Workman (Alt.)David Singer (Alt.)Distributed Management Task Force John Crandall Jeff Hillan
35、d (Alt.)Electronic Industries Alliance Edward Mikoski, Jr. Henry Cuschieri (Alt.)EMC Corporation . Gary RobinsonFarance, Inc. . Frank FaranceTimothy Schoechle (Alt.)GS1 US . Ray Delnicki Frank Sharkey (Alt.)James Chronowski (Alt.)Mary Wilson (Alt.)Hewlett-Packard Company Karen Higginbottom Paul Jera
36、n (Alt.)IBM Corporation Gerald Lane Robert Weir (Alt.)Arnaud Le Hors (Alt.)Debra Boland (Alt.)Steve Holbrook (Alt.)Alexander Tarpinian (Alt.)Provided by IHSNot for ResaleNo reproduction or networking permitted without license from IHS-,-,-vOrganization Represented Name of RepresentativeIEEE Terry de
37、CourcelleJodie Haasz (Alt.)Bob Labelle (Alt.)Joan Woolery (Alt.)Intel Philip Wennblom Grace Wei (Alt.)Stephen Balogh (Alt.)Lexmark InternationalDon Wright Dwight Lewis (Alt.)Paul Menard (Alt.)Jerry Thrasher (Alt.)Microsoft CorporationJim Hughes Dick Brackney (Alt.)John Calhoun (Alt.)National Institu
38、te of Standards - Create a market of Java components that are standard Java BioAPI BSPs, andthat can be used (along with a Java BioAPI framework) in Java environmentssuch as Java-based application servers, Java applets, or small Java-baseddevices; and - Increase the level of adoption of BioAPI by en
39、abling Java application developersto access C BSPs (as if they were Java BSPs) through special versions of theBioAPI framework that will bridge a standard Java BioAPI framework to astandard C BioAPI framework. Provided by IHSNot for ResaleNo reproduction or networking permitted without license from
40、IHS-,-,-AMERICAN NATIONAL STANDARD INCITS 474-2011American National Standard for Information Technology Biometric Application Programming Interface Java (BioAPI Java) 1 1 Scope The proposed standard will specify an interface of a BioAPI Java framework and BioAPI Java BSP and BioAPI BFP that will mir
41、ror the corresponding components specified in ISO/IEC 197841. Therefore, the position occupied by the proposed standard within the general picture of biometrics standards will be the same position that ISO/IEC 197841 occupies, the only difference being the programming language of the interfaces. The
42、 concepts such as BioAPI unit, component registry, etc. are present in this standard and will have the same meaning as in ISO/IEC 197841. The semantic equivalence of this standard will be maintained with ISO/IEC 197841, but there are differences in actual parameters passed between functions and the
43、sequence of function calls. These differences exist to take advantage of the object oriented benefits of Java. 2 Conformance Annex A specifies the conformance requirements for systems/components claiming conformance to this standard. 3 Normative References The following referenced documents are indi
44、spensable for the application of this document. For dated references, only the edition cited applies. For undated references, the latest edition of the referenced document (including any amendments) applies. ISO/IEC 197841:2006, Information Technology Biometric Application Programming Interface Part
45、 1: BioAPI Specification ANSI/INCITS 3982005, American National Standard Information technology Common Biometric Exchange Formats Framework (CBEFF) ISO/IEC 197851:2006, Information Technology Common Biometric Exchange Formats Framework Part 1: Data Element Specification ISO/IEC 197852:2006, Informat
46、ion Technology Common Biometric Exchange Formats Framework Part 2: Procedures for the Operation of the Biometric Registration Authority Provided by IHSNot for ResaleNo reproduction or networking permitted without license from IHS-,-,-INCITS 474-2011 4 Terms and Definitions For the purposes of this d
47、ocument, the following terms and definitions apply. These terms are defined in ISO/IEC 197841. 4.1 adaptation template adaptation use of a BIR produced from a newly captured and verified biometric sample to automatically update or refresh a reference template NOTE: This procedure is used to minimize
48、 the effects of template aging. 4.2 attach session temporary association between an application, a single BSP, and a set of BioAPI Units that are managed either directly or indirectly by that BSP 4.3 BioAPI component component of the BioAPI architecture with a defined interface that can be supplied by a separate vendor and which is subject to conformance testing NOTE: BioAPI components include BioAPI applications, the BioAPI Framework, BSPs, and BFPs. 4.4 BioAPI Function Provider BFP component that manages one or more BioAPI Unit