Package jmri.managers

Class DefaultIdTagManager

    • Field Detail

      • dirty

        protected boolean dirty
    • Method Detail

      • getXMLOrder

        public int getXMLOrder()
        Determine the order that types should be written when storing panel files. Uses one of the constants defined in this class.

        Yes, that's an overly-centralized methodology, but it works for now.

        Specified by:
        getXMLOrder in interface Manager<IdTag>
        Returns:
        write order for this Manager; larger is later.
      • registerSelf

        protected void registerSelf()
        By default, register this manager to store as configuration information. Override to change that. Don't want to store this information
        Overrides:
        registerSelf in class AbstractManager<IdTag>
      • provideIdTag

        @Nonnull
        public IdTag provideIdTag​(@Nonnull
                                  String name)
                           throws IllegalArgumentException
        Locate via tag ID, then user name, and finally system name if needed. If that fails, create a new IdTag. If the name is a valid system name, it will be used for the new IdTag. Otherwise, the makeSystemName method will attempt to turn it into a valid system name.
        Specified by:
        provideIdTag in interface IdTagManager
        Parameters:
        name - Tag ID, user name, system name, or address which can be promoted to system name
        Returns:
        A tag ID
        Throws:
        IllegalArgumentException - if IdTag doesn't already exist and the manager cannot create the IdTag due to an illegal name or name that can't be parsed.
      • getIdTag

        @CheckForNull
        public IdTag getIdTag​(@Nonnull
                              String name)
        Locate via tag ID, then by user name, and finally system name if needed. If that fails, return null
        Specified by:
        getIdTag in interface IdTagManager
        Parameters:
        name - tag name being requested
        Returns:
        null if no match found
      • newIdTag

        @Nonnull
        public IdTag newIdTag​(@Nonnull
                              String systemName,
                              @CheckForNull
                              String userName)
                       throws IllegalArgumentException
        Provide ID Tag by UserName then SystemName, creates new IdTag if not found. Return an instance with the specified system and user names. Note that two calls with the same arguments will get the same instance; there is only one IdTag object representing a given physical IdTag and therefore only one with a specific system or user name.

        This will always return a valid object reference; a new object will be created if necessary. In that case:

        • If a null reference is given for user name, no user name will be associated with the IdTag object created; a valid system name must be provided
        • If both are provided, the system name defines the hardware access of the desired IdTag, and the user address is associated with it. The system name must be valid.
        Note that it is possible to make an inconsistent request if both addresses are provided, but the given values are associated with different objects. This is a problem, and we don't have a good solution except to issue warnings. This will mostly happen if you're creating RfidTags when you should be looking them up.
        Specified by:
        newIdTag in interface IdTagManager
        Parameters:
        systemName - the system name
        userName - the user name
        Returns:
        requested IdTag object (never null)
        Throws:
        IllegalArgumentException - if cannot create the IdTag due to e.g. an illegal name or name that can't be parsed.
      • setStateStored

        public void setStateStored​(boolean state)
        Define if the manager should persist details of when and where all known IdTags were seen.
        Specified by:
        setStateStored in interface IdTagManager
        Parameters:
        state - True to store; False to omit
      • isStateStored

        public boolean isStateStored()
        Determines if the state of known IdTags should be stored.
        Specified by:
        isStateStored in interface IdTagManager
        Returns:
        True to store state; False to discard state
      • setFastClockUsed

        public void setFastClockUsed​(boolean fastClock)
        Define if the manager should use the fast clock when setting the times when a given IdTag was last seen.
        Specified by:
        setFastClockUsed in interface IdTagManager
        Parameters:
        fastClock - True to use the fast clock; False to use the system clock
      • isFastClockUsed

        public boolean isFastClockUsed()
        Determines if fast clock times should be recorded for when a given IdTag was last seen.
        Specified by:
        isFastClockUsed in interface IdTagManager
        Returns:
        True to use the fast clock; False to use the system clock
      • getTagsForReporter

        @Nonnull
        public List<IdTaggetTagsForReporter​(@Nonnull
                                              Reporter reporter,
                                              long threshold)
        Get a list of all IdTags seen by a specified Reporter within a specific time threshold from the most recently seen.
        Specified by:
        getTagsForReporter in interface IdTagManager
        Parameters:
        reporter - Reporter to return list for
        threshold - Time threshold (in ms)
        Returns:
        List of matching IdTags
      • getBeanTypeHandled

        @Nonnull
        public String getBeanTypeHandled​(boolean plural)
        Get the user-readable name of the type of NamedBean handled by this manager.

        For instance, in the code where we are dealing with just a bean and a message that needs to be passed to the user or in a log.

        Specified by:
        getBeanTypeHandled in interface Manager<IdTag>
        Parameters:
        plural - true to return plural form of the type; false to return singular form
        Returns:
        a string of the bean type that the manager handles, eg Turnout, Sensor etc
      • getNamedBeanClass

        public Class<IdTaggetNamedBeanClass()
        Get the class of NamedBean supported by this Manager. This should be the generic class used in the Manager's class declaration.
        Specified by:
        getNamedBeanClass in interface Manager<IdTag>
        Returns:
        the class supported by this Manager.