Package org.eclipse.keyple.core.service

Interface SmartCardService

public interface SmartCardService
Keyple main service.
Since:
2.0.0

  • Method Summary

    Modifier and Type
    Method
    Description
    void
    checkCardExtension(org.eclipse.keyple.core.common.KeypleCardExtension cardExtension)
    Verifies the compatibility with the service of the provided card extension.
    org.calypsonet.terminal.reader.selection.CardSelectionManager
    createCardSelectionManager()
    Create a new instance of a CardSelectionManager in order to perform a card selection.
    DistributedLocalService
    getDistributedLocalService(String distributedLocalServiceName)
    Returns the distributed local service having the provided name.
    Plugin
    getPlugin(String pluginName)
    Returns the plugin whose name is provided as an argument.
    Plugin
    getPlugin(org.calypsonet.terminal.reader.CardReader reader)
    Returns the plugin associated to the provided CardReader.
    Set<String>
    getPluginNames()
    Returns the names of all registered plugins.
    Set<Plugin>
    getPlugins()
    Returns all registered plugins.
    org.calypsonet.terminal.reader.CardReader
    getReader(String readerName)
    Returns the reader associated to the provided unique name.
    boolean
    isDistributedLocalServiceRegistered(String distributedLocalServiceName)
    Checks whether a distributed local service is already registered to the service or not.
    DistributedLocalService
    registerDistributedLocalService(org.eclipse.keyple.core.common.KeypleDistributedLocalServiceExtensionFactory distributedLocalServiceExtensionFactory)
    Registers a new distributed local service to the service.
    Plugin
    registerPlugin(org.eclipse.keyple.core.common.KeyplePluginExtensionFactory pluginFactory)
    Registers a new plugin to the service.
    void
    unregisterDistributedLocalService(String distributedLocalServiceName)
    Attempts to unregister the distributed local service having the provided name from the service.
    void
    unregisterPlugin(String pluginName)
    Attempts to unregister the plugin having the provided name from the service.

  • Method Details

    • registerPlugin

      Plugin registerPlugin(org.eclipse.keyple.core.common.KeyplePluginExtensionFactory pluginFactory)
      Registers a new plugin to the service.
      Parameters:
      pluginFactory - The plugin factory.
      Returns:
      A not null reference to the registered Plugin.
      Throws:
      KeyplePluginException - If instantiation failed.
      IllegalStateException - If the plugin has already been registered.
      Since:
      2.0.0

    • unregisterPlugin

      void unregisterPlugin(String pluginName)
      Attempts to unregister the plugin having the provided name from the service.
      Parameters:
      pluginName - The plugin name.
      Since:
      2.0.0

    • getPluginNames

      Set<String> getPluginNames()
      Returns the names of all registered plugins.
      Returns:
      A not null Set String.
      Since:
      2.0.0

    • getPlugins

      Set<Plugin> getPlugins()
      Returns all registered plugins.
      Returns:
      A not null Set of Plugin.
      Since:
      2.0.0

    • getPlugin

      Plugin getPlugin(String pluginName)
      Returns the plugin whose name is provided as an argument.
      Parameters:
      pluginName - The plugin name.
      Returns:
      Null if the plugin is not found or no longer registered.
      Since:
      2.0.0

    • getPlugin

      Plugin getPlugin(org.calypsonet.terminal.reader.CardReader reader)
      Returns the plugin associated to the provided CardReader.
      Parameters:
      reader - The card reader.
      Returns:
      Null if the plugin is not found or no longer registered.
      Since:
      2.1.0

    • getReader

      org.calypsonet.terminal.reader.CardReader getReader(String readerName)
      Returns the reader associated to the provided unique name.
      Parameters:
      readerName - The name of the card reader.
      Returns:
      Null if the reader is not found or no longer registered.
      Since:
      2.1.0

    • checkCardExtension

      void checkCardExtension(org.eclipse.keyple.core.common.KeypleCardExtension cardExtension)
      Verifies the compatibility with the service of the provided card extension.

      The verification is based on the comparison of the respective API versions.

      Parameters:
      cardExtension - A not null KeypleCardExtension reference object
      Since:
      2.0.0

    • registerDistributedLocalService

      DistributedLocalService registerDistributedLocalService(org.eclipse.keyple.core.common.KeypleDistributedLocalServiceExtensionFactory distributedLocalServiceExtensionFactory)
      Registers a new distributed local service to the service.
      Parameters:
      distributedLocalServiceExtensionFactory - Factory to use to instantiate a Distributed Local Service extension
      Returns:
      A not null reference to the registered DistributedLocalService.
      Throws:
      IllegalStateException - If the distributed local service has already been registered.
      Since:
      2.0.0

    • unregisterDistributedLocalService

      void unregisterDistributedLocalService(String distributedLocalServiceName)
      Attempts to unregister the distributed local service having the provided name from the service.
      Parameters:
      distributedLocalServiceName - The distributed local service name.
      Since:
      2.0.0

    • isDistributedLocalServiceRegistered

      boolean isDistributedLocalServiceRegistered(String distributedLocalServiceName)
      Checks whether a distributed local service is already registered to the service or not.
      Parameters:
      distributedLocalServiceName - The name of the distributed local service to be checked.
      Returns:
      True if the distributed local service is registered.
      Since:
      2.0.0

    • getDistributedLocalService

      DistributedLocalService getDistributedLocalService(String distributedLocalServiceName)
      Returns the distributed local service having the provided name.
      Parameters:
      distributedLocalServiceName - The name of the distributed local service.
      Returns:
      Null if the distributed local service is not found or no longer registered.
      Since:
      2.0.0

    • createCardSelectionManager

      org.calypsonet.terminal.reader.selection.CardSelectionManager createCardSelectionManager()
      Create a new instance of a CardSelectionManager in order to perform a card selection.
      Returns:
      A not null reference.
      Since:
      2.0.0