How bellyachx/masking-logger works
Masking Logger is a Java logging library that emits structured logs while masking sensitive data. Applications log through WLogger or Spring interception; the Logback encoder assembles structured events and applies configured masking before encoding output. The README documents JSON/XML masking configuration, request logging, and custom logging APIs. Request and method interception are separate entry paths into WLogger. Some internal wiring is not shown in the excerpts, so uncertain links are omitted or marked dashed.
Main entry points: MaskingJsonEncoder.java Logback Encoder · DataMaskerFactory.java Masker Factory · WLogger.java WLogger API · RequestMappingInterceptor.java HTTP Logging
Components 20
Logging API
- WLogger API
masking-logger-api/src/main/java/me/maxhub/logger/api/WLogger.java - Logger Specs
masking-logger-api/src/main/java/me/maxhub/logger/api/LoggerSpecImpl.java - Logging Annotations
masking-logger-annotations/src/main/java/me/maxhub/logger/Mask.java
Spring Integration
- Method Logging
masking-logger-spring/src/main/java/me/maxhub/logger/aop/LogAroundAdvice.java - HTTP Logging
masking-logger-spring/src/main/java/me/maxhub/logger/aop/http/RequestMappingInterceptor.java - Spring Autoconfiguration
masking-logger-autoconfig/src/main/java/me/maxhub/logger/RequestMappingInterceptorAutoconfiguration.java
Masking Engine
- Masker Factory
masking-logger-core/src/main/java/me/maxhub/logger/mask/DataMaskerFactory.java - Mask Support
masking-logger-core/src/main/java/me/maxhub/logger/mask/MaskSupport.java - JSON Masker V1
masking-logger-core/src/main/java/me/maxhub/logger/mask/impl/JsonMaskerV1.java - JSON Masker V2
masking-logger-core/src/main/java/me/maxhub/logger/mask/impl/JsonMaskerV2.java - XML Masker
masking-logger-core/src/main/java/me/maxhub/logger/mask/impl/XmlMasker.java - Specialized Maskers
maskers/src/main/java/me/maxhub/logger/IdentityNumberMasker.java
Encoding and Context
- Logback Encoder
masking-logger-core/src/main/java/me/maxhub/logger/logback/encoder/MaskingJsonEncoder.java - Structured Log Model
masking-logger-core/src/main/java/me/maxhub/logger/logback/encoder/model/LogModel.java - Body Encoders
masking-logger-core/src/main/java/me/maxhub/logger/mask/MessageEncoderFactory.java - Header Providers
masking-logger-core/src/main/java/me/maxhub/logger/headers/impl/DetailedHeadersProvider.java - Property Providers
masking-logger-core/src/main/java/me/maxhub/logger/properties/provider/PropertyProvider.java - Spring Context
masking-logger-core/src/main/java/me/maxhub/logger/spring/SpringContextHolder.java
Other components
- Application
- Logging Backend
Connections 21
- Application → WLogger API: logs through
README.md - WLogger API → Logger Specs: builds log specs
masking-logger-api/src/main/java/me/maxhub/logger/api/WLogger.java - Method Logging → WLogger API: logs method events
masking-logger-spring/src/main/java/me/maxhub/logger/aop/LogAroundAdvice.java - HTTP Logging → WLogger API: logs request and response
masking-logger-spring/src/main/java/me/maxhub/logger/aop/http/RequestMappingInterceptor.java - Spring Autoconfiguration → HTTP Logging: registers interceptor
masking-logger-autoconfig/src/main/java/me/maxhub/logger/RequestMappingInterceptorAutoconfiguration.java - Method Logging → Logging Annotations: reads annotations
masking-logger-spring/src/main/java/me/maxhub/logger/aop/LogAroundAdvice.java - HTTP Logging → Logging Annotations: reads annotations
masking-logger-spring/src/main/java/me/maxhub/logger/aop/http/RequestMappingInterceptor.java - WLogger API → Logback Encoder: emits events to
- Logback Encoder → Structured Log Model: builds
masking-logger-core/src/main/java/me/maxhub/logger/logback/encoder/MaskingJsonEncoder.java - Logback Encoder → Body Encoders: creates body encoder
masking-logger-core/src/main/java/me/maxhub/logger/logback/encoder/MaskingJsonEncoder.java - Logback Encoder → Masker Factory: creates masker factory
masking-logger-core/src/main/java/me/maxhub/logger/logback/encoder/MaskingJsonEncoder.java - Logback Encoder → Property Providers: reads configuration
masking-logger-core/src/main/java/me/maxhub/logger/logback/encoder/MaskingJsonEncoder.java - Logback Encoder → Header Providers: gets detailed headers
masking-logger-core/src/main/java/me/maxhub/logger/logback/encoder/MaskingJsonEncoder.java - Masker Factory → Property Providers: reads mask settings
masking-logger-core/src/main/java/me/maxhub/logger/mask/DataMaskerFactory.java - Masker Factory → JSON Masker V1: selects JSON masker
masking-logger-core/src/main/java/me/maxhub/logger/mask/DataMaskerFactory.java - Masker Factory → JSON Masker V2: selects JSON masker
masking-logger-core/src/main/java/me/maxhub/logger/mask/DataMaskerFactory.java - Masker Factory → XML Masker: selects XML masker
masking-logger-core/src/main/java/me/maxhub/logger/mask/DataMaskerFactory.java - JSON Masker V1 → Mask Support: uses masking support
masking-logger-core/src/main/java/me/maxhub/logger/mask/impl/JsonMaskerV1.java - Specialized Maskers → Mask Support: uses masking support
maskers/src/main/java/me/maxhub/logger/IdentityNumberMasker.java - Spring Context → Logback Encoder: provides Spring context
masking-logger-core/src/main/java/me/maxhub/logger/logback/encoder/MaskingJsonEncoder.java - Logback Encoder → Logging Backend: encodes log output
README.md