io microsphere spring context event BeanPropertyChangedEvent

BeanPropertyChangedEvent

Type: Class | Module: microsphere-spring-context | Package: io.microsphere.spring.context.event | Since: 1.0.0

Source: microsphere-spring-context/src/main/java/io/microsphere/spring/context/event/BeanPropertyChangedEvent.java

Overview

An event that is published when a property of a bean changes.

This event provides details about the bean whose property changed, the name of the property, and the old and new values of the property. It can be used to track changes in bean properties during runtime.

Example Usage

// Create and publish the event when a bean's property changes
BeanPropertyChangedEvent event = new BeanPropertyChangedEvent(myBean, "status", oldStatus, newStatus);
applicationEventPublisher.publishEvent(event);

Declaration

public class BeanPropertyChangedEvent extends ApplicationEvent

Author: Mercy

Version Information

• Introduced in: 1.0.0
• Current Project Version: 0.2.27-SNAPSHOT

Version Compatibility

This component is tested and compatible with the following Java versions:

Java Version	Status
Java 17	✅ Compatible
Java 21	✅ Compatible
Java 25	✅ Compatible

Examples

// Create and publish the event when a bean's property changes
BeanPropertyChangedEvent event = new BeanPropertyChangedEvent(myBean, "status", oldStatus, newStatus);
applicationEventPublisher.publishEvent(event);

Method Examples

getBean

BeanPropertyChangedEvent event = new BeanPropertyChangedEvent(myBean, "event", null, newValue);
  Object bean = event.getBean();
  assertSame(myBean, bean);

getPropertyName

BeanPropertyChangedEvent event = new BeanPropertyChangedEvent(myBean, "event", null, newValue);
  assertEquals("event", event.getPropertyName());

getOldValue

BeanPropertyChangedEvent event = new BeanPropertyChangedEvent(myBean, "event", null, newValue);
  assertNull(event.getOldValue());

getNewValue

BeanPropertyChangedEvent event = new BeanPropertyChangedEvent(myBean, "event", null, newValue);
  assertSame(newValue, event.getNewValue());

Usage

Maven Dependency

Add the following dependency to your pom.xml:

<dependency>
    <groupId>io.github.microsphere-projects</groupId>
    <artifactId>microsphere-spring-context</artifactId>
    <version>${microsphere-spring.version}</version>
</dependency>

Tip: Use the BOM (microsphere-spring-dependencies) for consistent version management. See the Getting Started guide.

Import

import io.microsphere.spring.context.event.BeanPropertyChangedEvent;

API Reference

Public Methods

Method	Description
getBean	The constructor
getPropertyName	Returns the name of the property that was changed.
getOldValue	Returns the value of the property before the change.
getNewValue	Returns the value of the property after the change.

Method Details

getPropertyName

public String getPropertyName()

Returns the name of the property that was changed.

Example Usage

`BeanPropertyChangedEvent event = new BeanPropertyChangedEvent(myBean, "event", null, newValue);
  assertEquals("event", event.getPropertyName());
`

getOldValue

public Object getOldValue()

Returns the value of the property before the change.

Example Usage

`BeanPropertyChangedEvent event = new BeanPropertyChangedEvent(myBean, "event", null, newValue);
  assertNull(event.getOldValue());
`

getNewValue

public Object getNewValue()

Returns the value of the property after the change.

Example Usage

`BeanPropertyChangedEvent event = new BeanPropertyChangedEvent(myBean, "event", null, newValue);
  assertSame(newValue, event.getNewValue());
`

See Also

• ApplicationEvent

---

This documentation was auto-generated from the source code of microsphere-spring.