贴一篇我的Javadoc

简介: <div class="markdown_views"><pre class="prettyprint"><code class=" hljs java"><span class="hljs-javadoc">/** * <h1>虚拟礼品卡 soa接口</h1> * <pre> * <h2>调用说明</h2>
/**
 * <h1>虚拟礼品卡 soa接口</h1>
 * <pre>
 * <h2>调用说明</h2>
 * <li>引入pom</li>
 *      {@code <dependency>
 *          <groupId>com.jd.bizopen.v</groupId>
 *          <artifactId>jd-bizopen-v-soa-sdk</artifactId>
 *          <version>1.0.6</version>
 *      </dependency>}
 * <li>加入jsf配置</li>
 *      {@code <jsf:consumer id="giftCardService" interface="com.jd.sns.biz.api.service.GiftCardService" 
 *          protocol="jsf" alias="{jsf.version}" timeout="3000" check="false" >}
 *      jsf.version 测试环境test, 生产环境product
 * </pre>
 * 
 * @author cdwangzijian
 * @since 1.0.6
 * @version 1.0.6
 * 
 */
public interface GiftCardService {
    /**
     * <h3>礼品卡下单接口</h3>
     * 
     * @param giftcardOrder {@link GiftcardOrder}
     * @return 
     * <pre>
     *     {@link GiftcardSku}
     *     {@link ResultBase}
     *     {@link SubmitResult}
     * </pre>
     */
    public SubmitResult<GiftcardSku> submit(GiftcardOrder giftcardOrder);

    /**
     * <h3>指定条件分页查询订单</h3>
     * 
     * @param query {@link VirtualOrderQuery}
     * @return 该接口如果内部出现异常时,返回值为null,调用方注意判断空指针。没有查询结果则返回空集合
     * <pre>
     *     {@link Page}
     *     {@link GiftcardVirtualOrder}
     * </pre>
     */
    public Page<GiftcardVirtualOrder> selectGiftcardOrderByPage(VirtualOrderQuery query);
}

一个自带入参表的Javadoc

package com.jd.sns.biz.api.vo;

import java.io.Serializable;
import com.jd.sns.biz.api.enumtype.ErrorCode;
/**
 * <h1>返回结果基础类</h1>
 * 
 * <style type="text/css">
 *      table
 *      {
 *          border-collapse: collapse;
 *          border: none;
 *      }
 *      th
 *      {
 *          border: solid #000 1px;
 *      }
 *      td
 *      {
 *          border: solid #000 1px;
 *      }
 *  </style>
 * <table cellspacing=1>
 * <thead  bgcolor="#a1a1a1" >
 *  <tr>
 *      <th>字段</th>
 *      <th>名称</th>
 *      <th>类型</th>
 *      <th>描述</th>
 *  </tr>
 * </thead>
 * <tbody>
 *  <tr>
 *      <td>success</td>
 *      <td>成功标识</td>
 *      <td>boolean</td>
 *      <td>true:成功, false:失败</td>
 *  </tr>
 *  <tr>
 *      <td>resultMessage</td>
 *      <td>返回信息</td>
 *      <td>String</td>
 *      <td>对应返回码的说明</td>
 *  </tr>
 *  <tr>
 *      <td>resultCode</td>
 *      <td>返回码</td>
 *      <td>String</td>
 *      <td>返回码 {@link ErrorCode}</td>
 *  </tr>
 * </tbody>
 * </table> 
 * 
 * @author cdwangzijian
 * @since 1.0.6
 * @version 1.0.6
 *
 */
public class ResultBase implements Serializable{
    private static final long serialVersionUID = 1L;
    protected boolean success;
    protected String resultMessage = "";
    protected String resultCode;

    public boolean isSuccess() {
        return success;
    }
    public void setSuccess(boolean success) {
        this.success = success;
    }
    public String getResultMessage() {
        return resultMessage;
    }
    public void setResultMessage(String resultMessage) {
        this.resultMessage = resultMessage;
    }
    public String getResultCode() {
        return resultCode;
    }
    public void setResultCode(String resultCode) {
        this.resultCode = resultCode;
    }
}

看下效果:
这里写图片描述

另外贴一下mvn生成javadoc的命令:mvn javadoc:javadoc

相关文章
|
物联网 数据安全/隐私保护 芯片
RFID 寄存器初始化 | 学习笔记
快速学习 RFID 寄存器初始化
RFID 寄存器初始化 | 学习笔记
|
存储 安全 前端开发
基于springboot的流浪动物救助管理系统
基于springboot的流浪动物救助管理系统
|
Python
python中的单引号、双引号和多引号
python中的单引号、双引号和多引号
699 0
|
10月前
|
监控 安全 数据安全/隐私保护
一个典型的DRM系统的工作流程:
【10月更文挑战第30天】个典型的DRM系统的工作流程:
373 3
|
Java Android开发
全志 Android 11:实现响应全局按键
本文介绍了在全志平台Android 11上实现响应全局按键的方法,通过修改`TvWindowManager.java`来全局拦截特定的热键事件,并在`FocusActivity`中处理这些事件以启动调焦界面和控制步进电机调整焦距。
132 2
|
Windows
【Azure 环境】在Windows环境中抓取网络包(netsh trace)后,如何转换为Wireshark格式以便进行分析
【Azure 环境】在Windows环境中抓取网络包(netsh trace)后,如何转换为Wireshark格式以便进行分析
395 0
|
人工智能 PyTorch 算法框架/工具
【人工智能】Transformers之Pipeline(六):图像分类(image-classification)
【人工智能】Transformers之Pipeline(六):图像分类(image-classification)
222 0
|
监控 Java API
如何从 Java 程序中查找内存使用情况
【8月更文挑战第22天】
1057 0
|
消息中间件 存储 缓存
不看损失大了,刨根问底,Kafka消息中间件到底会不会丢消息
不看损失大了,刨根问底,Kafka消息中间件到底会不会丢消息
871 112
不看损失大了,刨根问底,Kafka消息中间件到底会不会丢消息
|
Java Linux 数据安全/隐私保护
Burp Suite的使用(常用模块)
Burp Suite的使用(常用模块)
375 1

热门文章

最新文章