###
使用注解编写第一个程序
在现代 Java
开发中，
注解是一种非常强大的工具，它能够显著减少样板代码并提高
开发效率。以下是基于
Spring Boot 的一个简单示例，展示如何通过
注解快速构建一个应用程序。
#### 1
. 创建项目结构
首先创建一个标准的 Maven 或 Gradle 项目，并确保其具有 `
spring-boot-starter` 依赖项。这一步可以通过 IDE 插件或者手动编辑 `pom
.xml` 文件完成[^4]。
```
xml
<dependencies>
<!-- 引入
Spring Boot Starter -->
<dependency>
<groupId>org
.springframework
.boot</groupId>
<artifactId>
spring-boot-starter</artifactId>
</dependency>
<!-- 测
试支持 -->
<dependency>
<groupId>org
.springframework
.boot</groupId>
<artifactId>
spring-boot-starter-test</artifactId>
<scope>test</scope>
</dependency>
</dependencies>
```
#### 2
. 编写主类
使用 `@
SpringBootApplication`
注解标记主类。此
注解是一个复合
注解，包含了 `@
SpringBootConfiguration`, `@EnableAutoConfiguration` 和 `@ComponentScan` 功能[^3]。
```java
import org
.springframework
.boot
.SpringApplication;
import org
.springframework
.boot
.autoconfigure
.SpringBootApplication;
@
SpringBootApplication
public class MyFirstApplication {
public static void main(String[] args) {
SpringApplication
.run(MyFirstApplication
.class, args);
}
}
```
上述代码会启动
Spring Boot 应用程序，并自动加载配置文件以及扫描指定包下的组件。
#### 3
. 定义控制器
为了演示 RESTful API 接口的功能，可以定义一个简单的控制器类：
```java
import org
.springframework
.web
.bind
.annotation
.GetMapping;
import org
.springframework
.web
.bind
.annotation
.RequestMapping;
import org
.springframework
.web
.bind
.annotation
.RestController;
@RestController
@RequestMapping("/api")
public class HelloController {
@GetMapping("/hello")
public String sayHello() {
return "Hello from the first annotated program!";
}
}
```
这里
使用了 `@RestController` 来表明这是一个返回 JSON 数据的控制器，而不是渲染视图模板；同时利用了 `@RequestMapping` 和 `@GetMapping` 进行路径映射[^1]。
#### 4
. 添加自定义
注解（可选）
如果希望扩展功能，还可以
尝试实现自己的
注解。比如下面的例子展示了如何验证方法参数的有效性[^2]:
```java
import javax
.validation
.ConstraintValidator;
import javax
.validation
.ConstraintValidatorContext;
// 自定义约束逻辑
public class NotNullAndRangeValidator implements ConstraintValidator<NotNullAndRange, String> {
private int max;
@Override
public void initialize(NotNullAndRange constraintAnnotation) {
this
.max = constraintAnnotation
.max();
}
@Override
public boolean isValid(String value, ConstraintValidatorContext context) {
if (value == null || value
.isEmpty()) {
return false; // 不允许为空字符串
}
try {
int num = Integer
.parseInt(value); //
尝试转换为整数
return num >= 0 && num <= max; // 判断范围是否合法
} catch (NumberFormatException e) {
return false; // 如果无法解析，则认为非法
}
}
}
// 自定义
注解声明
import java
.lang
.annotation
.ElementType;
import java
.lang
.annotation
.Retention;
import java
.lang
.annotation
.RetentionPolicy;
import java
.lang
.annotation
.Target;
import javax
.validation
.Constraint;
import javax
.validation
.Payload;
@Constraint(validatedBy = NotNullAndRangeValidator
.class)
@Target({ElementType
.METHOD, ElementType
.FIELD})
@Retention(RetentionPolicy
.RUNTIME)
public @interface NotNullAndRange {
String message() default "Value must be a number between 0 and specified maximum
.";
Class<?>[] groups() default {};
Class<? extends Payload>[] payload() default {};
int max(); // 参数化最大值
}
```
然后可以在任何需要的地方应用这个新创建的
注解：
```java
public class ExampleService {
public void processInput(@NotNullAndRange(max=100) String input) throws Exception {
System
.out
.println("Processing valid input: " + input);
}
}
```
---
#### 总结
以上就是
使用注解开发的第一个完整程序实例。从项目的搭建到核心业务逻辑的设计都体现了
注解的强大之处及其带来的便利性。
本文探讨了Spring和Hibernate采用注解配置后的变化。Spring通过@Component等注解简化了Bean的配置，而Hibernate则利用注解SessionFactoryBean实现了实体类的一次性配置。这些改变大大减少了XML配置工作，并提升了开发效率。
扫一扫
6347
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
