VALOBS

A collection of commonly used VALue OBjectS in enterprise applications

What are value objects?

In Domain-Driven Design (DDD), a Value Object is one of the building blocks used to model the domain. Value Objects are objects whose equality is determined by the value of their attributes rather than by their identity. In other words, two Value Objects are considered equal if they have the same set of attribute values, even if they are distinct instances.

Here are some key characteristics and considerations for Value Objects in DDD:

• Immutability: Value Objects are typically immutable, meaning their state cannot be changed once they are created. This immutability ensures that the value of a Value Object remains constant throughout its lifetime.

• Equality: Equality of Value Objects is based on the equality of their attributes. If two Value Objects have the same attribute values, they are considered equal, regardless of their individual identity.

• Identity Ignored: Unlike entities, which have a distinct identity, Value Objects do not have a conceptual identity. They are defined only by their attributes. This means that if you create a new Value Object with the same attribute values as an existing one, they are considered equal.

• Side-Effect-Free: Value Objects should not have any side effects. Operations on Value Objects should not change the state of the system or other objects.

• Examples: Common examples of Value Objects include simple types such as strings, numbers, and dates, as well as more complex structures like Money, Address, or PhoneNumber. These objects are characterized by the fact that their identity is determined by their attribute values.

Using Value Objects in your domain model helps to clarify the semantics of the model and can lead to more expressive and intention-revealing code. They are particularly useful for modeling concepts in your domain that are defined by their attributes rather than their identity.

Why VALOBS?

In enterprise applications, there are many common concepts that are represented as Value Objects. These concepts often have well-defined attributes and behaviors, and are used across different domains and applications. Examples include dates, times, money, addresses, and phone numbers.

VALOBS is a collection of commonly used Value Objects that can be used as building blocks in your domain model. By using these pre-defined Value Objects, you can avoid reinventing the wheel and ensure consistency and correctness in your domain model. You can also take advantage of the best practices and patterns that are built into these Value Objects.

Will it cover all possible Value Objects?

No, it won't.

The list of Value Objects in VALOBS is not exhaustive, and it is not intended to cover every possible Value Object that you might encounter in your domain. Instead, it focuses on the most common and widely used Value Objects that are applicable to a wide range of domains and applications.

Collated List

Numeric Values

• Integer
• Decimal
• Percentage
• Ratio
• CurrencyAmount
• MeasurementUnit
• Fraction

Temporal Values

• Date
• Time
• DateTime
• Duration
• TimeInterval
• Timezone

Geographical Values

• Latitude
• Longitude
• GeoLocation
• Address
• Country
• Continent

Communication

• EmailAddress
• PhoneNumber
• URL
• SocialMediaHandle
• PostalAddress

Identification

• UUID
• GUID
• SerialNumber
• NationalID
• PassportNumber
• EmployeeID

Measurement

• Length
• Weight
• Volume
• Area
• Temperature
• Speed

Textual Values

• Name
• Description
• Title
• Comment
• TextContent
• Tag

Financial Values

• Money
• CurrencyExchangeRate
• CreditCard
• PaymentTransaction
• Invoice
• FinancialAmount

Code and Configuration

• StatusCode
• ConfigurationParameter
• FeatureToggle
• CodeSnippet
• VersionNumber
• APIKey

Security

• Password
• HashValue
• EncryptionKey
• DigitalSignature
• OAuthToken
• APIAccessToken

Media and Files

• File
• Image
• Video
• Audio
• Document
• FileFormat

Social and Networking

• ProfileID
• ConnectionRequest
• RelationshipStatus
• Notification
• GroupID
• ChatMessage

Health and Fitness

• HeartRate
• BloodPressure
• CaloricIntake
• StepsCount
• BMI
• SleepDuration

Scientific Values

• ScientificNotation
• AtomicNumber
• MolecularWeight
• pHValue
• Gravity

Education

• StudentID
• CourseCode
• Grade
• EducationalInstitution
• Transcript
• ExamScore

Transportation

• VehicleIdentificationNumber (VIN)
• LicensePlate
• Route
• FlightNumber
• TicketNumber
• FuelConsumption

Environmental Values

• CarbonFootprint
• PollutionIndex
• RenewableEnergyProduction
• EnvironmentalImpact

Legal and Compliance

• ContractID
• ComplianceStatus
• LegalCaseNumber
• RegulatoryApproval
• LicenseNumber

Custom Codes and Identifiers

• CustomCode
• UniqueIdentifier
• BusinessID
• EntityCode
• ReferenceNumber

Miscellaneous

• Barcode
• Color
• ISBN
• DomainName
• Language
• DeviceID

Numeric Units

• Speed (e.g., meters per second)
• Acceleration
• Voltage
• Current
• Resistance
• Frequency

Temporal Intervals

• FiscalYear
• AcademicTerm
• BookingPeriod
• ProjectTimeline
• Season
• EpochTime

Geographical Regions

• State
• Province
• City
• District
• Neighborhood
• Landmark

Communication Channels

• CommunicationProtocol
• MessagingQueue
• ChatRoom
• VoIPCallID
• BroadcastChannel

Identification Verification

• BiometricData
• FacialRecognitionData
• VoicePrint
• Fingerprint
• RetinaScan

Measurement Accuracy

• PrecisionLevel
• Tolerance
• MarginOfError
• Sensitivity
• CalibrationValue

Textual Styles

• FontStyle
• TextAlignment
• MarkupLanguage
• WritingStyle
• LanguageVariant

Financial Transactions

• TransactionID
• BankingTransactionType
• InvestmentPortfolio
• TaxID
• PayoutAmount

Code and Configuration Settings

• ConfigurationKey
• EnvironmentVariable
• FeatureFlagStatus
• DebugMode
• LogLevel

Security Access

• AccessControlList (ACL)
• PermissionSet
• SecurityClearanceLevel
• BiometricAccessLevel
• SecureToken

Media Metadata

• MetadataTag
• ExifData
• CopyrightInformation
• DigitalAssetID
• MediaResolution

Social Interactions

• SocialEventID
• AttendeeList
• SocialInteractionType
• SocialGroupID
• EventLocation

Health Metrics

• CholesterolLevel
• BloodSugarLevel
• FitnessGoal
• HealthInsurancePolicy
• MedicalHistory

Scientific Constants

• PlanckConstant
• AvogadroNumber
• GravitationalConstant
• SpeedOfLight
• BoltzmannConstant

Educational Achievements

• DiplomaID
• Certification
• DegreeType
• AcademicAward
• GraduationStatus

Transportation Routes

• TrafficCondition
• NavigationRoute
• RouteOptimization
• TransportationMode
• ParkingSpotID

Environmental Conservation

• EcologicalFootprint
• BiodiversityIndex
• EnvironmentalPolicy
• ConservationAreaID

Legal Documents

• LegalDocumentID
• LegalCaseStatus
• CourtOrder
• LegalRepresentation
• NotarizationRecord

Custom Identifiers

• CustomIdentifier
• EntityAlias
• ReferenceCode
• ClientID
• VendorCode

Miscellaneous Concepts

• AugmentedRealityMarker
• VirtualRealityEnvironment
• SubscriptionPlan
• TradeOrderID
• UniqueDeviceIdentifier (UDID)