Package opencard.opt.service

Class OCF11CardServiceFactory

  • Direct Known Subclasses:
    PassThruCardServiceFactory
    public abstract class OCF11CardServiceFactory
extends CardServiceFactory
    A CardServiceFactory can instantiate CardServices for a specific smart card. Typically, the CardServiceRegistry will instantiate a CardServiceFactory once a smart card has been inserted for which a waitForCard() method was invoked.

    Note: This CardServiceFactory subclass maps the new style CardServiceFactory interface (using getCardType() and getClasses()) to the OCF 1.1 style card service factories using the deprecated knows() and cardServiceClasses() methods. Existing factories should inherit from this class to preserve compatibility.

    Version:
    $Id: OCF11CardServiceFactory.java,v 1.3 1999/11/03 12:37:19 damke Exp $
    Author:
    Peter Bendel (peter_bendel@de.ibm.com)
    See Also:
    CardService, CardServiceFactory, CardType, CardID

    • Constructor Detail

      • OCF11CardServiceFactory

        public OCF11CardServiceFactory()
        Instantiate a CardServiceFactory.

    • Method Detail

      • getCardType

        protected CardType getCardType​(CardID cid,
                               CardServiceScheduler scheduler)
        Indicate whether this CardServiceFactory "knows" the smart card OS and/or installed card applications and might be able to instantiate CardServices for it.

        This method replaces the former knows() method. Note: OCF 1.1 style card service factories should instead derive from opencard.opt.service.OCF11CardServiceFactory which still offers the knows() and cardServiceClasses() methods.

        Should return a CardType that contains enough information to answer the getClassFor() method.

        The factory can inspect the card (communicate with the card) using the provided CardServiceScheduler if the CardID information is insufficient to classify the card.

        Specified by:
        getCardType in class CardServiceFactory
        Parameters:
        cid - A CardID received from a Slot.
        scheduler - A CardServiceScheduler that can be used to communicate with the card to determine its type.
        Returns:
        A valid CardType if the factory can instantiate services for this card. CardType.UNSUPPORTED if the factory does not know the card.
        See Also:
        getClasses(opencard.core.service.CardType)

      • getClasses

        protected java.util.Enumeration getClasses​(CardType type)
        Return an enumeration of known CardService classes.

        Replaces the former cardServiceClasses() method. Note: OCF 1.1 style card service factories should instead derive from opencard.opt.service.OCF11CardServiceFactory which still offers the knows() and cardServiceClasses() methods.

        Specified by:
        getClasses in class CardServiceFactory
        Parameters:
        type - The CardType of the smart card for which the enumeration is requested.
        Returns:
        An Enumeration of class objects.

      • knows

        protected abstract boolean knows​(CardID cid)
        Indicate whether this CardServiceFactory "knows" the smart card OS represented by cid and might be able to instantiate CardServices for it.
        Parameters:
        cid - A CardID received from a Slot.

      • cardServiceClasses

        protected abstract java.util.Enumeration cardServiceClasses​(CardID cid)
        Return an enumeration of known CardService classes.
        Parameters:
        cid - The CardID of the smart card for which the enumeration is requested.
        Returns:
        An Enumeration of class objects.