Java开发笔记(八十一)如何使用系统自带的注解
之前介绍继承的时候,提到对于子类而言,父类的普通方法可以重写也可以不重写,但是父类的抽象方法是必须重写的,如果不重写,编译器就直接在子类名称那里显示红叉报错。例如,以前演示抽象类用法之时,曾经把Chicken鸡类的call方法改为抽象方法,方法声明代码如下所示:
- // 定义一个抽象的叫唤方法。注意后面没有花括号,并且以分号结尾
- abstract public void call();
倘若派生自鸡类的公鸡类没有重写call方法,编译器除了红叉报错以外,还会弹出提示“Add unimplemented method”,也就是建议开发者为公鸡类补充实现call方法。按照建议点击提示文字,eclipse会自动在公鸡类中添加以下的默认代码:
- @Override
- public void call() {
- // TODO Auto-generated method stub
- }
注意到新增的call方法上面一行,多出了形如“@Override”的标记,该标记看起来似乎是多余的,即使把它删掉,编译器也不会报错,程序也能正常运行。莫非“@Override”是另一种形式的注释?实际上,以@符号开头的标记,它们的真正名称叫做“注解”,跟“注释”仅有一字之差,二者的关系恰如名字那样,既有相同点又有不同点。相同点为:注解一样带有解释说明的涵义,比如Override翻译成中文就是“重写”的意思,表示标记下方的call方法重写了父类的抽象方法。不同点为:注释是给人看的,而注解还要给编译器看,编译器扫描到注解@Override,便会去检查父类是否存在注解下方的方法声明,如果不存在或者参数类型对不上,就会提示红叉错误。
除了方法重写注解“@Override”之外,还有一种常见的注解叫“@FunctionalInterface”,翻译成中文便是“函数式接口”,猜的没错,该注解专门用来标记Java8规定的函数式接口。函数式接口是一类特殊的接口形式,它的内部有且仅有一个抽象方法,抽象方法多了不行,再来一个抽象方法的话,接口实例就没法简写为Lambda表达式,也就无法成为“函数式”接口。Java自带的几个函数式接口包括:比较器Comparator、断言接口Predicate、消费接口Consumer、函数接口Function、文件过滤器FileFilter、运行器Runnable等等,查看它们的源码,会发现接口定义的上方无一例外都存在注解“@FunctionalInterface”。例如下面是比较器Comparator的核心定义代码:
- //该注解表示以下定义的是函数式接口,有且仅有一个抽象方法声明。
- //如果同时声明了多个抽象方法,则编译器在编码阶段就会报错。
- @FunctionalInterface
- public interface Comparator<T> {
- int compare(T o1, T o2);
- // 此处省略比较器接口的剩余代码定义
- }
@FunctionalInterface注解明白无误地告诉编译器,它的下方接口是个函数式接口,请务必检查这个接口定义是否符合函数式接口的要求。编译器根据注解的指示,立即扫描注解下方的接口代码,并仔细统计接口内部的抽象方法个数,倘若抽象方法的数量不足一个或者多于一个,编译器都会提示错误“Invalid '@FunctionalInterface' annotation; *** is not a functional interface”,意思是“注解@FunctionalInterface是无效的,因为***不是一个函数式接口”,这样正好提醒开发者检查接口定义是否存在问题。
第三种常见的注解名叫“@Deprecated”,早前介绍日期工具Date的时候,在代码中调用日期实例的getYear、getMonth、getDate等方法,这几个方法的名称中间居然出现了一条删除线。查看相关日期方法的源码,才发觉它们的定义代码上方耸立着注解“@Deprecated”,该注解的含义是“不赞成、已废弃”,缘由是Java认为这几个日期方法已经过时了,随时都会从开发包中移除,建议开发者将它们替换成日历工具里的对应方法。尽管目前仍然可以在代码中调用这些过时的方法,但是编译器依旧按照规定在方法名称中间显示删除线,并且还会给出警告“Add @SupressWarnings 'deprecated' to '***'”。这警告说的是建议往***添加注解“@SupressWarnings”(含义为屏蔽警告),从而避免此处的警告提示。正所谓“眼不见心不烦”,那就按照建议在日期方法的调用处统统添加新注解“@SuppressWarnings("deprecation")”,添加完了,果然这些“已过时”的警告都被屏蔽掉了。
注解@SuppressWarnings不仅可用来屏蔽“已过时”的警告,还能用来屏蔽其它类型的警告,譬如“未使用”这类警告。上一篇文章演示私有方法的反射调用之时,给Chicken类增加了setName、getName、setSex、getSex四个私有方法,这些方法并未被Chicken类自身所调用,编译器会认为它们是“未使用”的方法,因而在这四个方法的定义处提示警告信息“Remove method '***'”,也就是建议删除某某某方法。如果程序员仍想保留这些方法,又不想看到警告提示,则可在Chicken类上方添加注解“@SuppressWarnings("unused")”,表示屏蔽未使用的警告。添加了@SuppressWarnings注解的鸡类定义代码片段示例如下:
- //该注解表示屏蔽“未使用”这种警告
- @SuppressWarnings("unused")
- abstract public class Chicken {
- // 此处省略鸡类的其它代码定义
- private void setName(String name) { // 设置名称
- this.name = name;
- }
- private String getName() { // 获取名称
- return this.name;
- }
- private void setSex(int sex) { // 设置性别
- this.sex = sex;
- }
- private int getSex() { // 获取性别
- return this.sex;
- }
- }
上面的四种注解中,@Override、@Deprecated、@SuppressWarnings这三种是从Java5开始引入的,而@FunctionalInterface是在Java8才引入的。除此之外,Java7还引入了第五种注解名叫“@SafeVarargs”,主要目的是兼容可变参数中的泛型参数,该注解告诉编译器:此处可变参数中的泛型是类型安全的,不必担心强制类型转换的问题。由于前述的五种注解是系统提供给开发者使用的,因此它们被统称为“内置注解”。
更多Java技术文章参见《Java开发笔记(序)章节目录》
Java开发笔记(八十一)如何使用系统自带的注解的更多相关文章
- (八十一)利用系统自带App来实现导航
利用系统的地图App进行导航,只需要传入起点和终点.启动参数,调用MKMapItem的类方法openMapWithItems:launchOptions:来实现定位,调用此方法后会打开系统的地图App ...
- Java开发笔记(十一)常见的数学函数
前面介绍了Java编程的四则运算,虽然提供了基础的加减乘除符号,但是数学上还有其它运算符号,包括四舍五入用到的约等号≍.求绝对值的“| |”.开平方的“√ ̄”,这些运算符形态各异,而且并非ASCII码 ...
- Java开发笔记(序)章节目录
现将本博客的Java学习文章整理成以下笔记目录,方便查阅. 第一章 初识JavaJava开发笔记(一)第一个Java程序Java开发笔记(二)Java工程的帝国区划Java开发笔记(三)Java帝国的 ...
- Java开发笔记(八十六)通过缓冲区读写文件
前面介绍了利用文件写入器和文件读取器来读写文件,因为FileWriter与FileReader读写的数据以字符为单位,所以这种读写文件的方式被称作“字符流I/O”,其中字母I代表输入Input,字母O ...
- Java开发笔记(三十八)利用正则表达式校验字符串
前面多次提到了正则串.正则表达式,那么正则表达式究竟是符合什么定义的字符串呢?正则表达式是编程语言处理字符串格式的一种逻辑式子,它利用若干保留字符定义了形形色色的匹配规则,从而通过一个式子来覆盖满足了 ...
- Java开发笔记(一百五十一)Druid连接池的用法
C3P0连接池自诞生以来在Java Web领域反响甚好,业已成为hibenate框架推荐的连接池.谁知人红是非多,C3P0在大型应用场合中暴露了越来越多的局限性,包括但不限于下列几点:1.C3P0管理 ...
- Java开发笔记(一百三十八)JavaFX的箱子
前面介绍了JavaFX标签控件的用法,其中提到Label文本支持中文字体,那么它到底支持哪些中文字体呢?自然要看当前的操作系统都安装了哪些字体才行,对于中文的Windows系统,默认安装了黑体“Sim ...
- Java开发笔记(八十九)缓存字节I/O流
文件输出流FileOutputStream跟FileWriter同样有个毛病,每次调用write方法都会直接写到磁盘,使得频繁的写操作性能极其低下.正如FileWriter搭上了缓存兄弟Buffere ...
- Java开发笔记(八十八)文件字节I/O流
前面介绍了如何使用字符流读写文件,并指出字符流工具的处理局限,进而给出随机文件工具加以改进.随机文件工具除了支持访问文件内部的任意位置,更关键的一点是通过字节数组读写文件数据,采取字节方式比起字符方式 ...
随机推荐
- 【.NET异步编程系列2】掌控SynchronizationContext避免deadlock
引言: 多线程编程/异步编程非常复杂,有很多概念和工具需要去学习,贴心的.NET提供Task线程包装类和await/async异步编程语法糖简化了异步编程方式. 相信很多开发者都看到如下异步编程实践原 ...
- Access2007数据库下载地址与AccessHelper
链接:https://pan.baidu.com/s/1pLzOlTv0nqSbhzujHZht1w 提取码:1m9l AccessHelper: using System; using System ...
- 使用强类型实体Id来避免原始类型困扰(一)
原文地址:https://andrewlock.net/using-strongly-typed-entity-ids-to-avoid-primitive-obsession-part-1/ 作者: ...
- 约定Jenkins构建脚本
对于Jenkins的使用,我感觉只用到其中一小部分功能,但也就是这一小部分功能,也推动了整个CI/CD的过程,Jenkins的使用方式有很多中,可能我用到的只是其中一种,但是已经满足我的需求,便不再贪 ...
- Python进阶:如何将字符串常量转化为变量?
前几天,我们Python猫交流学习群 里的 M 同学提了个问题.这个问题挺有意思,经初次讨论,我们认为它无解. 然而,我认为它很有价值,应该继续思考怎么解决,所以就在私密的知识星球上记录了下来. 万万 ...
- C# Memory Cache 踩坑记录
背景 前些天公司服务器数据库访问量偏高,运维人员收到告警推送,安排我团队小伙伴排查原因. 我们发现原来系统定期会跑一个回归测试,该测运行的任务较多,每处理一条任务都会到数据库中取相关数据,高速地回归测 ...
- Asp.Net Core 轻松学-使用MariaDB/MySql/PostgreSQL和支持多个上下文对象
前言 在上一篇文章中(Asp.Net Core 轻松学-10分钟使用EFCore连接MSSQL数据库)[https://www.cnblogs.com/viter/p/10243577.html],介 ...
- App 更换应用图标
一般情况下,我们App图标在Androidmanifest.xml中设置,通过Application android:icon属性指定,写法如下: <?xml version="1.0 ...
- 8天入门docker系列 —— 第二天 通过一个aspnetcore程序加深对容器的理解
我们知道容器是一个打包了应用和相关依赖的盒子,那怎么去操控这个盒子呢? 这一篇我通过一个简单的aspnetcore程序来加深对盒子的理解,使用之前先 安装一下Docker的环境. 一:Docker的安 ...
- netcore编程之后面对不习惯的xshell黑屏部署,是时候使用jenkins自动化发布工具了
在很久之前net还只能在windows上部署的时候,或许很多创业公司的朋友发布项目还都是人肉部署,反正windows都是可视化的界面,拖拖拉拉,开开关关还不 是特别麻烦...现如今你的项目需要在li ...