A股上市公司传智教育(股票代码 003032)旗下技术交流社区北京昌平校区

 找回密码
 加入黑马

QQ登录

只需一步,快速开始

© 杜成龙 中级黑马   /  2013-4-15 09:43  /  1588 人查看  /  5 人回复  /   0 人收藏 转载请遵从CC协议 禁止商业使用本文

本帖最后由 杜成龙 于 2013-4-17 18:24 编辑

程序如下:
/*
这是一个可以对数组进行操作的工具类,该类中提供了,获取最值,排序等功能。
@author 张三
@version V1.1
*/
public class  ArrayTool
{
/*
空参数构造函数。
*/
private ArrayTool(){}
/*
获取一个整型数组中的最大值。
@param arr 接收一个int类型的数组。
@return 会返回一个该数组中的最大值。
*/
public static int getMax(int[] arr)
{
  int max=0;
  for(int x=1;x<arr.length;x++)
  {
   if(arr[x]>arr[max])
    max=x;
  }
  return arr[max];
}
/*
获取一个整型数组中的最小值。
@param arr 接收一个int类型的数组。
@return 会返回一个该数组中的最小值。
*/
public static int getMin(int[] arr)
{
  int min=0;
  for(int x=1;x<arr.length;x++)
  {
   if(arr[x]<arr[min])
    min=x;
  }
  return arr[min];
}
/*
给int型数组进行选择排序。
@param arr 接收一个int类型的数组。
*/
public static void selectSort(int[] arr)
{
  for(int x=0;x<arr.length-1;x++)
  {
   for(int y=x+1;y<arr.length;y++)
   {
    if(arr[x]>arr[y])
    {
     swap(arr,x,y);
    }
   }
  }
}
/*
给int型数组进行冒泡排序。
@param arr 接收一个int类型的数组。
*/
public static void bubbleSort(int[] arr)
{
  for(int x=0;x<arr.length-1;x++)
  {
   for(int y=0;y<arr.length-x-1;y++)
   {
    if(arr[y]>arr[y+1])
    {
     swap(arr,y,y+1);
    }
   }
  }
}
/*
给数组中的元素进行位置的置换。
@param arr 接收一个int型的数组。
@param a 要置换的位置
@param b 要置换的位置
*/
private static void swap(int[] arr,int a,int b)
{
  int temp=arr[a];
  arr[a]=arr;
  arr=temp;
}
/*
用于打印数组中的元素。打印形式是:(element1,element2, 。。。)
*/
public static void printArray(int[] arr)
{
  System.out.print("[");
  for(int x=0;x<arr.length;x++)
  {
   if(x!=arr.length-1)
    System.out.print(arr[x]+",");
   else
    System.out.println(arr[x]+"]");
  }
}
}
生成的说明书如下:

类 ArrayTool

  • java.lang.Object


    • ArrayTool



  • public class ArrayToolextends java.lang.Object




    • 方法概要 方法 限定符和类型方法和说明
      static void[url=file:///E:/EditPlus%203/file/inst/ArrayTool.html#bubbleSort(int[])]bubbleSort[/url](int[] arr)
      static int[url=file:///E:/EditPlus%203/file/inst/ArrayTool.html#getMax(int[])]getMax[/url](int[] arr)
      static int[url=file:///E:/EditPlus%203/file/inst/ArrayTool.html#getMin(int[])]getMin[/url](int[] arr)
      static void[url=file:///E:/EditPlus%203/file/inst/ArrayTool.html#printArray(int[])]printArray[/url](int[] arr)
      static void[url=file:///E:/EditPlus%203/file/inst/ArrayTool.html#selectSort(int[])]selectSort[/url](int[] arr)

      • 从类继承的方法 java.lang.Objectclone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait






    • 方法详细资料

      • getMaxpublic static int getMax(int[] arr)

      • getMinpublic static int getMin(int[] arr)

      • selectSortpublic static void selectSort(int[] arr)

      • bubbleSortpublic static void bubbleSort(int[] arr)

      • printArraypublic static void printArray(int[] arr)





我想请问为什么生成的说明书中没有参数和返回值等文字说明?请大家指点一下,谢谢啦~~


评分

参与人数 1技术分 +1 收起 理由
黄玉昆 + 1

查看全部评分

5 个回复

倒序浏览
你确定你那样写出来的代码能生成javadoc?
标准格式应该是;
/**
*这是一个可以对数组进行操作的工具类,该类中提供了,获取最值,排序等功能。
*@author 张三
*@version V1.1
*/

评分

参与人数 1技术分 +1 收起 理由
黄玉昆 + 1

查看全部评分

回复 使用道具 举报
HM刘俊 发表于 2013-4-15 10:33
你确定你那样写出来的代码能生成javadoc?
标准格式应该是;
/**

可以的,我试过,生成的就是上面的结果,我发现只要注释前面是/**的话就对了,但如果只有一个*,像这样
/* 就生成上面的结果,不知是什么原因?
回复 使用道具 举报
杜成龙 发表于 2013-4-15 12:45
可以的,我试过,生成的就是上面的结果,我发现只要注释前面是/**的话就对了,但如果只有一个*,像这样
/ ...

可能就是书写的规范问题吧。
回复 使用道具 举报
javadoc格式应该是;                     
/**
*这里呢写你次类的作用,里面提供了什么方法和功能。
*@author 张
*@version java1.5
*/

1,必须是文本注释。
2, @author    这里是作者
3,@version   这里是版本

评分

参与人数 1技术分 +1 收起 理由
黄玉昆 + 1

查看全部评分

回复 使用道具 举报
如果问题未解决,请继续追问,如果没有问题了,请将帖子分类 改为“已解决”,谢谢
回复 使用道具 举报
您需要登录后才可以回帖 登录 | 加入黑马