docs: 4.0.1 fixes, permit waits, renewal scripts, handler and @Async rules
- Limitations: a permit wait that Redisson never ends, Redisson's extra
renewal scripts, a lock wait that runs out while subscribing is "not
acquired", functional endpoint bodies, and lazy, prototype or scoped
handlers declared by their interface
- Configuration: a RedissonClient from any auto-configuration, JDK-proxy
beans, which interface's annotation a class bean takes, the WARN and
ERROR lines
- Failure handling: how a handler bean may be declared
- With other Spring annotations: @Async on the bean's class, and an order
on @EnableAsync or @EnableResilientMethods
- Key templates: #root and #this
- Semaphores, Locks, Programmatic API: wording and links
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
290726a
docs: return types that run after the lock is released
- Limitations: Spring MVC's async return types fail startup, and a call
that returns pending work through a wider type logs an ERROR
- Configuration: the startup check and the ERROR line
- With other Spring annotations: the ERROR for an @Async body's unfinished
future, and Spring MVC's async types
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
ed712e7
docs: link the demo from Home
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
7f54324
docs: add two limitations and the spring.aop.auto note
- An interrupted wait can cost the next waiter its turn
- Spring Data repository fragments are coordinated twice
- spring.aop.auto=false also gives interface proxies
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
54f9936
docs: rebuild the wiki for Locksmith 4.0.0
- Replace the 3.x pages with ten pages and a sidebar written for 4.0.0
- The 3.x pages remain in this history
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
7873c90
docs: update rate limit metric names from locksmith.ratelimit to locksmith.rate.limit
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2103bdb
docs: fix wiki issues — link casing, version ref, RateLimitConfigurationException, migration risk
- Fix WikiSpelExamplesTest link text to match actual filename WikiSpELExamplesTest.java
- Update Troubleshooting version reference from v2.1+ to v3.0+
- Add RateLimitConfigurationException troubleshooting section covering
invalid permits/interval and cross-deployment config mismatches
- Document transition window risk when changing semaphore permit counts
in both Distributed-Semaphores and Troubleshooting pages
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
efa5359
docs: update wiki for v3.0.3 release
- Bump versions to Locksmith 3.0.3, Redisson 4.3.0, Spring Boot 4.0.3
- Fix SpEL key syntax in annotation reference (use #{#orderId})
- Clarify RateType is from Redisson, not Locksmith
- Add RateLimitConfigurationException documentation
- Fix Auto-Renew page title formatting
- Add semaphore lease expiration detection section
- Update skip handlers and metrics docs to include rate limit
- Simplify configuration validation description
7c09629
docs: update wiki for builder-only template API with try-with-resources
Update Programmatic-Templates and Micrometer-Metrics pages to reflect
the new builder-only API: withKey() entry point, LockHandle/PermitHandle
for try-with-resources, and removal of simple methods (tryLock, forKey,
executeWithLock, tryAcquirePermit, executeWithPermit, executeWithRateLimit).
c7adc10
docs: fix debug log format and autoRenew onLeaseExpired description
- Update Troubleshooting debug log examples to match actual code output
(INFO level, includes type/mode/leaseTime/waitTime fields)
- Clarify that autoRenew only warns for THROW_EXCEPTION, not the
default LOG_WARNING which is silently ignored
- Fix debug log examples in Auto-Renew-Lease-Time page
c4f86c8
docs: update wiki for v3.0.0 release
Update all version references from 2.1.0 to 3.0.0 and Redisson from
4.1.0 to 4.2.0. Add v3.0.x to compatibility matrix. Update verification
log output to match actual format. Add v2.x to v3.0 migration guide
covering new @RateLimit annotation and rate-limit properties. Fix
AcquisitionMode description to include @RateLimit.
f62a3dd
fix: update Spring Boot version to 4.0.2 in example pom.xml
0984d73
fix: restore Maven POM schema version to 4.0.0
0b0ec9b
docs: add rate limiting documentation for v2.1.0
- Add new Rate-Limiting.md with comprehensive @RateLimit documentation
- Update Home.md with rate limiting overview and quick examples
- Update Installation.md with v2.1.0 and Redisson 4.1.0 versions
- Update Configuration.md with rate-limit properties and enabled flags
- Update Annotation-Reference.md with @RateLimit, RateType, RateLimitContext
- Update Skip-Handlers.md with rate limit handlers section
- Update Programmatic-Templates.md with LocksmithRateLimitTemplate
- Update Micrometer-Metrics.md with rate limit metrics
- Update Troubleshooting.md with rate limit issues section
- Update Lock-Acquisition-Modes.md to include rate limits
- Update Dynamic-Keys-with-SpEL.md with rate limit examples
- Update High-Concurrency-Best-Practices.md to mention rate limiters
07e1296
docs: add Micrometer metrics integration documentation
4688914
docs: add Programmatic Templates documentation
Add wiki page for LocksmithLockTemplate and LocksmithSemaphoreTemplate
programmatic API for distributed locks and semaphores.
Features documented:
- Simple tryLock/unlock and tryAcquirePermit/releasePermit methods
- Callback pattern with executeWithLock/executeWithPermit
- Builder API for custom wait time, lease time, lock types
- Auto-renewal support for locks
- Comparison between annotations and templates
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
240683e
Add High Concurrency Best Practices
3509151
feat: add support for Optional in default return values and update README
9d0796e
docs: add Spring bean dependency injection support for skip handlers
- Update Skip-Handlers.md with new Spring Bean Integration section
- Document handler resolution order: Spring bean lookup first, reflection fallback
- Add examples for @Component handlers with constructor injection
- Update Annotation-Reference.md skipHandler sections for both locks and semaphores
- Remove outdated "Current Limitation" note about reflection-only instantiation
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
411c086
Updated documentation for semaphore context permit id
02f4a71
Fix outdated config in Lock-Acquisition-Modes.md
Update wait-time configuration to use new nested structure
(locksmith.lock.wait-time and locksmith.semaphore.wait-time)
aa3481f
Rename LockAcquisitionMode to AcquisitionMode
The enum is now simply called AcquisitionMode since it's used by both
@DistributedLock and @DistributedSemaphore annotations.
30c1345
Updated _Footer (markdown)
82c5750
Created _Footer (markdown)
3b089b6
Add distributed semaphore support and update wiki structure
- Update Home.md to be an overview page with links to both lock and semaphore docs
- Rename Basic-Usage.md to Distributed-Locks.md with enhanced content
- Create Distributed-Semaphores.md with comprehensive semaphore documentation
- Update Configuration.md with new nested structure (locksmith.lock.*/semaphore.*)
- Update Installation.md with v2.0.0 and migration guide
- Update Annotation-Reference.md with @DistributedSemaphore annotation
- Update Skip-Handlers.md with semaphore handlers (SemaphoreSkipHandler, SemaphoreContext)
- Update Troubleshooting.md with semaphore-specific issues
Breaking changes documented:
- Configuration now uses locksmith.lock.* and locksmith.semaphore.* prefixes
- Previous locksmith.lease-time now locksmith.lock.lease-time
22c714a
Update all wiki pages with correct SpEL syntax and remove emojis
- Update Home.md, Basic-Usage.md, Annotation-Reference.md, Lock-Types.md with #{...} wrapper
- Remove emojis from Dynamic-Keys-with-SpEL.md and Lock-Types.md
- All SpEL expressions now correctly show #{#param} syntax
- Literal keys examples clarified
ae5d417
Remove emojis from Troubleshooting guide
fe68e44