Class: Hoodoo::UUID

Inherits:
Object
  • Object
show all
Defined in:
lib/hoodoo/utilities/uuid.rb

Overview

Class that handles generation and validation of UUIDs. Whenever you want to associate an identifier with something, you should use this class rather than (e.g.) relying on identifiers generated by a database. This allows you to cluster your database later on, should your application become big enough, without having to worry about ID synchronisation across instances.

Constant Summary collapse

MATCH_16_PAIRS_OF_HEX_DIGITS =

A regexp which, as its name suggests, only matches a string that contains 16 pairs of hex digits (with upper or lower case A-F).

stackoverflow.com/questions/287684/regular-expression-to-validate-hex-string

/^([[:xdigit:]]{2}){16}$/

Class Method Summary collapse

Class Method Details

.generate ⇒ Object

Generate a unique identifier. Returns a 32 character string.



23
24
25
 
# File 'lib/hoodoo/utilities/uuid.rb', line 23

def self.generate
  UUIDTools::UUID.random_create().hexdigest()
end

.valid?(uuid) ⇒ Boolean

Checks if a UUID string is valid. Returns true if so, else false.

uuid

UUID string to validate. Must be a String, 32 characters long (as 16 hex digit pairs) and parse to a valid result internally, according to internal UUID generation rules.

Note that the validity of a UUID says nothing about where, if anywhere, it might have been used. So, just because a UUID is valid, doesn’t mean you have (say) stored something with that UUID as the primary key in a row in a database.

Returns:

  • (Boolean) 


38
39
40
41
42
 
# File 'lib/hoodoo/utilities/uuid.rb', line 38

def self.valid?( uuid )
  uuid.is_a?( ::String )                           &&
  ( uuid =~ MATCH_16_PAIRS_OF_HEX_DIGITS ) != nil  &&
  UUIDTools::UUID.parse_hexdigest( uuid ).valid?()
end