Sonic: Meituan's Hot Deployment IDEA Plugin – Architecture and Implementation

Introduction

Sonic is an internal Meituan IDEA plugin that enables hot deployment of Java applications without restarting the JVM. The article explains the motivation, design, and practical experience of deploying Sonic in a large‑scale production environment.

Why Hot Deployment?

Developers at Meituan restart services 5‑12 times daily, each taking 3‑8 minutes locally, and perform 3‑5 remote deployments per day, each lasting 20‑45 minutes. The plugin reduces code‑change latency to seconds, improving both self‑testing and integration testing workflows.

Sonic Capabilities

Sonic supports incremental deployment of multiple file types (Java classes, Spring Bean, Spring XML, MyBatis XML) and provides features such as traffic replay, remote invocation, and remote decompilation. In practice, a typical 20‑35 minute deployment cycle can be shortened to 5‑10 seconds.

Overall Architecture

Sonic consists of four components: a script side that prepares launch parameters, an IDEA plugin side that offers a UI, an Agent side that runs inside the target JVM, and a server side that collects metrics and reports failures. The components interact to form a complete deployment loop.

Agent and Instrumentation

The Agent uses the Java Instrumentation API to add transformers, retransform or redefine classes, and query loaded classes. Key methods include addTransformer, retransformClasses, and redefineClasses. The Agent can operate both via Premain (startup) and Agent‑on‑Attach (runtime) mechanisms.

public interface Instrumentation {
    void addTransformer(ClassFileTransformer transformer, boolean canRetransform);
    void addTransformer(ClassFileTransformer transformer);
    boolean removeTransformer(ClassFileTransformer transformer);
    boolean isRetransformClassesSupported();
    void retransformClasses(Class<?>... classes) throws UnmodifiableClassException;
    boolean isRedefineClassesSupported();
    void redefineClasses(ClassDefinition... definitions) throws ClassNotFoundException, UnmodifiableClassException;
    Class[] getAllLoadedClasses();
}

DCEVM Integration

Because JDK 7/8 cannot change class structure (add fields, methods, or change super‑classes), Sonic leverages the open‑source Dynamic Code Evolution Virtual Machine (DCEVM) to overcome this limitation, allowing addition or removal of members at runtime.

File Listening and Classpath Extension

Sonic watches two directories: /var/tmp/sonic/extraClasspath (custom classpath) and /var/tmp/sonic/classes (monitored files). When a file changes, the IDEA plugin pushes the update to the remote or local target, and the Agent loads the new class via an extended classpath URL, avoiding direct modification of JAR‑packed resources.

JVM Class Reload

The Agent creates ClassDefinition objects from the new bytecode and calls Instrumentation.redefineClasses. This triggers Spring’s transformation hooks to reload the affected components.

Spring Bean Reload

When a Java class changes, Spring scans the classpath, removes the old bean definition via BeanDefinitionRegistry.removeBeanDefinition, and destroys the bean instance. To handle parent‑child contexts, Sonic updates both the parent and child contexts, ensuring that downstream beans receive the refreshed instance. Different entry points (Spring MVC, Mthrift, Pigeon) use tailored reload strategies.

Spring XML Reload

Modifications to Spring XML trigger a full reload of the affected beans. Currently only simple bean additions or modifications are supported to avoid global AOP and processor side‑effects.

MyBatis Reload

Sonic tracks MyBatis Configuration objects, maps them to the Spring context, and reloads the configuration when related class or XML files change, achieving hot deployment for MyBatis mappers.

Adoption and Results

As of the article’s writing, Sonic is used by over 3,000 developers on more than 2,000 projects within Meituan, achieving a hot‑deployment success rate above 99.9 %. It received the “Best Efficiency Team” award in Meituan’s internal R&D platform.