BlogJava-软件工程实践者-随笔分类-Java Domain

BlogJava-软件工程实践者-随笔分类-Java Domainhttp://www.blogjava.net/robin/category/6575.htmlzh-cnSun, 18 Sep 2016 09:11:09 GMTSun, 18 Sep 2016 09:11:09 GMT60Java 8 Repeatable注解的使用http://www.blogjava.net/robin/archive/2016/09/06/431753.html软件工程实践者软件工程实践者Tue, 06 Sep 2016 08:24:00 GMThttp://www.blogjava.net/robin/archive/2016/09/06/431753.htmlhttp://www.blogjava.net/robin/comments/431753.htmlhttp://www.blogjava.net/robin/archive/2016/09/06/431753.html#Feedback0http://www.blogjava.net/robin/comments/commentRss/431753.htmlhttp://www.blogjava.net/robin/services/trackbacks/431753.html

public class SampleClass {

    @Quality("Security")
    @Quality("Performance")
    @Quality("Readability")
    public void foo(){
        //
    }
}

Java 8引入了Repeatable注解（@Repeatable）可以解决这一问题，但光有可重复的注解定义还不够，还需要它的容器注解，两者一起来实现可重复注解的使用。实例如下：

@Target(ElementType.METHOD)
@Retention(RetentionPolicy.SOURCE)
@Repeatable (Qualities.class)
public @interface Quality {
String value();
}

@Target(ElementType.METHOD)
public @interface Qualities {
Quality[] value();
}

其中，Quality是可重复注解，由@Repeatable注解标明，它的容器注解是Qualities，用于存放所有可重复的Quality（存贮在Quality[]中）；同时还要注意可重复注解和它的容器注解的目标元素必须是一样的（这也不言自明）。如此这般，我们最开始的 SampleClass 在Java 8环境下就可以安全使用了。

软件工程实践者 2016-09-06 16:24 发表评论

]]>Bill Push的单例模式实现http://www.blogjava.net/robin/archive/2016/09/03/431736.html软件工程实践者软件工程实践者Sat, 03 Sep 2016 01:37:00 GMThttp://www.blogjava.net/robin/archive/2016/09/03/431736.htmlhttp://www.blogjava.net/robin/comments/431736.htmlhttp://www.blogjava.net/robin/archive/2016/09/03/431736.html#Feedback0http://www.blogjava.net/robin/comments/commentRss/431736.htmlhttp://www.blogjava.net/robin/services/trackbacks/431736.html该方法利用了Java缺省的Lazy类实例化机制克服了传统单例模式实现中Lazy实例化方式的不足。

public class Singleton {
   private Singleton(){}

   public static Singleton getInstance(){
      return Helper.instance;
   }

   static class Helper {
       private static Singleton instance = new Singleton();
   }
}

软件工程实践者 2016-09-03 09:37 发表评论

]]>Mustang(jdk1.6)特性http://www.blogjava.net/robin/archive/2006/01/11/27569.html软件工程实践者软件工程实践者Wed, 11 Jan 2006 05:10:00 GMThttp://www.blogjava.net/robin/archive/2006/01/11/27569.htmlhttp://www.blogjava.net/robin/comments/27569.htmlhttp://www.blogjava.net/robin/archive/2006/01/11/27569.html#Feedback1http://www.blogjava.net/robin/comments/commentRss/27569.htmlhttp://www.blogjava.net/robin/services/trackbacks/27569.html1. 提供了磁盘分区 - 空间方法

在File类中增加了以下方法：
public long getFreeSpace(): 返回一个分区剩余空间
public long getTotalSpace(): 返回一个分区总空间
public long getUsableSpace(): 返回一个分区已用空间
注意，以上File指代的虚拟路径必须是盘符，否则返回0。

2. Splash Screen

Mustang对于Splash Screen的实现是一个用来显示gif（可以是动画式的）,PNG, jpg图片的没有修饰的窗口
使用方式：
在java命令行中加入 -splash 选项,示例如下：
java -splash mypic.jpg HelloWorld

如果你的类是以jar的方式来运行，那么可以在jar文件的MANIFEST.MF文件中加入如下的一行：
SplashScreen-Image:mypic.jpg

你也可以在命令行中写：
java -splash:mypic.jpg -jar helloWorld.jar
这里用的图片将替代MANIFESET.MF中定义的图片（如果有的话）

为了实现自定义的Splash Screen界面，你可以使用如下的方法：

//使用SplashScreen的静态方法获得SplashScreen对象，然后自定义
SplashScreen ss = SplashScreen.getSplashScreen ();
if (ss != null)
{
// 自定义代码。
}

在SpalshScreen中还提供了如下方法，具体使用请看JDK或访问sun网站
public Graphics getGraphics()
public URL getImageURL()
public Dimension getSize()
public void setImageURL(URL imageURL):
public void update()

值得注意的是：你必须使用 -spalsh选项或MANIFEST.MF的方式来调用SplashScreen，
否则修改是无效的。

软件工程实践者 2006-01-11 13:10 发表评论

]]>如何编写子定义annotation及使用JDK5.0 annotation包中的annotationshttp://www.blogjava.net/robin/archive/2006/01/02/26309.html软件工程实践者软件工程实践者Mon, 02 Jan 2006 02:31:00 GMThttp://www.blogjava.net/robin/archive/2006/01/02/26309.htmlhttp://www.blogjava.net/robin/comments/26309.htmlhttp://www.blogjava.net/robin/archive/2006/01/02/26309.html#Feedback0http://www.blogjava.net/robin/comments/commentRss/26309.htmlhttp://www.blogjava.net/robin/services/trackbacks/26309.html@Documented，@Retention，@Target，@Inherited

1. 编写自定义@Todo注解
经常我们在写程序时，有时候有些功能在当前的版本中并不提供，或由于某些其它原因，有些方法没有完成，而留待以后完成，我们在javadoc中用@TODO来描述这一行为，下面用java注解来实现。

public @interface Todo { } // Todo.java

如果你想让这个注解类型能够自省的话，给它加上@Todo注解，写法如下：

@Todo
public @interface Todo{ }

下面我们给这个注解接受参数的能力，代码如下：

@Todo("Just articleware")
public @interface Todo{
  public enum Priority { LOW, MEDIUM, HIGH }
  String value();
  String[] owners() default "";
  Priority priority() default Priority.MEDIUM;
}

注意：注解类性所能接受的参数类型有着严格的规则：
a. 参数类型只能是：primitive, String, Class, enum, annotation, 或者是数组；
b. 参数值不能为空，因此每一个参数值都要定义一个缺省值；
c. 名字为value的参数可以用简便的方法来设置；
d. 参数的写法如同写简单方法（看如上代码），不允许加入参数，不允许有throws子句等。

在上面的代码中，我们为@Todo定义了3个参数, 分别是value, owners, priority. 注意：由于value的特殊性，它的的却省值可以由上面代码中的"Just articleware"来定义，当然你也可以单独写一个缺省值。

下面看一个应用@Todo注解的例子：

@Todo(
  value="Class scope",
  priority=Unfinished.Priority.LOW
)
public class TodoDemo {

  @Todo("Constructor scope")//通过快捷方式，设置value的值
  public TodoDemo() { }

  @Todo(owner="Jason", value="Method scope")
  public void foo() { }
}

上面的代码很简单，不多介绍。

下面我们想让@Todo不能应用在fields, parameters, 或者local variables（因为这对我们来说没有意义）；它应当可以出现在javadoc中；在运行是具有持久性。要实现这些特性，就需要annotation包的支持啦。

2. 应用annotation包的支持

1）@Documented
类和方法的annotation缺省情况下是不出现在javadoc中的，为了加入这个性质我们用@Documented
应用代码如下(简单，不多介绍）：

package com.robin;
import java.lang.annotation.*;

@Todo("Just articleware")
@Documented
public @interface Todo{ ...

2）@Retention
用来表明你的annotation的有效期，可以有三种选择(如图所示)：

以下示例代码应用RUNTIME策略

package com.robin;
import java.lang.annotation.*;

@Todo("Just articleware")
@Documented
@Retention(RetentionPolicy.RUNTIME)
public @interface Todo{ ...

3) @Target
@Target注解表明某个注解应用在哪些目标上，可选择如下范围:



ElementType.TYPE (class, interface, enum) 
ElementType.FIELD (instance variable) 
ElementType.METHOD ElementType.PARAMETER 
ElementType.CONSTRUCTOR 
ElementType.LOCAL_VARIABLE 
ElementType.ANNOTATION_TYPE (应用于另一个注解上) 
ElementType.PACKAGE

按我们的功能要求，代码如下：

package com.robin;
import java.lang.annotation.*;

@Todo("Just articleware")
@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.TYPE,ElementType.METHOD,
 ElementType.CONSTRUCTOR,ElementType.ANNOTATION_TYPE,
 ElementType.PACKAGE})
public @interface Todo{ ...

4) @Inherited
@Inherited表明是否一个使用某个annotation的父类可以让此annotation应用于子类。
示例代码如下：

package com.robin;
import java.lang.annotation.*;

@Todo("Just articleware")
@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.TYPE,ElementType.METHOD,
 ElementType.CONSTRUCTOR,ElementType.ANNOTATION_TYPE,
 ElementType.PACKAGE})
@Inherited
public @interface Todo{
  public enum Priority { LOW, MEDIUM, HIGH }

  String value();
  String[] owners() default "";
  Priority priority() default Priority.MEDIUM;
}

软件工程实践者 2006-01-02 10:31 发表评论

]]>J2SE 5.0的三种内置注释类型http://www.blogjava.net/robin/archive/2006/01/01/26283.html软件工程实践者软件工程实践者Sun, 01 Jan 2006 13:41:00 GMThttp://www.blogjava.net/robin/archive/2006/01/01/26283.htmlhttp://www.blogjava.net/robin/comments/26283.htmlhttp://www.blogjava.net/robin/archive/2006/01/01/26283.html#Feedback2http://www.blogjava.net/robin/comments/commentRss/26283.htmlhttp://www.blogjava.net/robin/services/trackbacks/26283.html注解(annotation)是J2SE 5.0的新内容，它给我们提供了很好的编程支持，下面介绍一下其内置的三种注解类型：

1. @Override

@Override用在多态情况下，比如：

public abstract class Animal{
   public void say(){
      System.out.println("annimal is saying");
   }
}

public class Cat extends Animal{
    @Override
    public void say(){
        System.out.println("miao, miao");
    }
}

通过@Override来告诉java编译器，say方法是重载的父类的方法，这样，当父类的say方法签名改名的话，比如增加了一些参数，那么子类的Cat中的say方法编译时就会报错，说没有正确的重载父类方法，所以，@Override可以帮我们验证程序的正确性，这一点，很有用。

2. @Deprecated

@Deprecated的意思和JavaDoc中的@deprecated注释在本质上是一样的，使用如下：

public class DeprecatedExample { @Deprecated public static void badMethod() { } } public class DeprecatedUser { public static void main(String[] args){ DeprecatedExample.badMethod(); } }
上面的代码如果用javac进行编译的话，会打印出如下信息:
Note: DeprecatedUser.java uses or overrides a deprecated API.
Note: Recompile with -Xlint:deprecation for details.
1 error
如果你按提示重新加-Xlint进行编译，你就可以得到错误的详细信息：
% javac -Xlint:deprecation
DeprecatedUser.java:3: warning: [deprecation] badMethod() in DeprecatedExample
has been deprecated
DeprecatedExample.badMethod();

需要注意的是：和javadoc中的@deprecated相比，@Deprecated并没有强大多少，因为它不支持参数，而@deprecated后面还可以跟字符串来给一些相关的信息，但@Deprecated做不到，但它提供了运行时自省的功能，来提示错误，所以建议@Deprecated和@deprecated同时使用。

3. @SuppressWarnings

顾名思义，就是抑制警告信息的出现，使用如下：
public class DeprecatedExample2{ @Deprecated public static void foo() { } } public class DeprecatedUser2 { @SuppressWarnings(value={"deprecation"}) public static void main(String[] args) { DeprecatedExample2.foo(); } }
上述@SuppressWarnings(value={"deprecation"})的作用就是抑制编译器报deprecation的错。
@SuppressWarnings(value={"deprecation"})只支持一个参数，是数组类型，所以你可以不用加value, 写成：@SuppressWarnings({"deprecation"})；当想抑制多个类型的警告信息时，可写：@SuppressWarnings({"unchecked","fallthrough",deprecation"}).

注意：在JDK1.5.0 release中，@SuppressWarnings还没有得到完全支持，会在以后支持，但Sun并没有给出具体的时间。

软件工程实践者 2006-01-01 21:41 发表评论

]]>