JAVA---API、异常

API

定义：应用程序编程接口，即jdk文档手册，里面以类的形式提供了很多常用功能

常用的包与类：
       java.lang包：因为常用，所以不需要导包。 如:字符串，线程
       java.util包：数组功能类，日期，集合等
       java.net包：网络相关的类型
       java.io包：输入输出类型
       java.math包：数学应用的相关类型 

打包工具：javadoc
      (1)使用命令提示符界面：
                  类信息中没有声明包，即使用默认包 ------- javadoc -d path *.java
                   path:生成api文档的位置
                  类信息中声明了包 ---- javadoc -d path nameOfPackage
                  如：package com
                  javadoc -d .\doc com
           
                 源文件在不同包下：
                javadoc -d path nameOfPackage1 nameOfPackage2
                如： javadoc -d .\doc com demo
           
       (2)借助eclipse
           export---java---javadoc-->选择javadoc命令的路径-->选中要生成文档的项目-->选择生成文档的位置 

异常 

 在程序开发过程中出现的不正常现象，就是异常。比如，除数是0，参数为null，调用参数的成员变量或者方法，数组下标越界。 

异常分为两大类型：
   (1)exception:程序员可以解决的：如空指针，除数是0,数组下标越界
   (2)Error:程序员无法解决的：如内存溢出 

exceptin的分类：
       按照编译器是否检查进行分类：
       非检查性异常：也称之为运行时异常，即编译器在检查语法期间不做异常检查。
       检查性异常：也称之为编译时异常，此时，编译器会强制检查语法中的异常情况，
                            如有异常在编译期需要做异常处理。 

exception的结构:
    RuntimeException:
             NullPointerException
             ArrayIndexOutOfBoundsException
             ClassCastException
             IllegalArgumentException
             NumberFormatException
             
    IOException:
             EOFException
             FileNotFoundException 

 异常的处理:
      (1)当异常出现时，终止程序
      (2)当异常出现时，我们使用处理机制进行处理异常，无需终止程序
      
            体验度：尽可能的选择异常处理机制
异常处理机制：
       基本思想：在可能出现异常的代码块区域，进行尝试检查，如果出现了异常信息， 我们将这些信息封装成某一异常类                            型的对象，然后进行捕获与处理。
                        
   try{
           可能出现异常的代码块
     /*如果有异常，jvm会将异常信息，封装成对象
              将地址信息赋值给catch中的形参
     */
   }catch(Exception e){
          进行处理e
   }
   
多catch语句块情况：
       当我们在尝试捕获异常对象时，想对多种不同的异常对象分别处理时，需要使用多个catch语句块。
    
       说明:当在try中出现了异常信息，那么就不会再执行try代码块的后续部分。 进入相应的catch代码块中执行处理。
          
       多catch语句块情况下：catch处理的异常种类书写顺序：先写子类异常类型，再写父类异常 

throw

抛出关键字，在本方法中出现的异常，不做try-catch处理，而是抛给调用者处理。需要使用throw关键字。   

        
throws

声明异常关键字，通常用于方法的定义上，用于通知调用者。

       当throw的异常对象为检查性异常，方法上必须throws声明此异常类型。
       如果throw的异常对象为非检查性异常，方法上不必throws此异常。
       
方法重写时的throws的用法
     可行的：
         (1)可以相同
         (2)可以是部分
         (3)异常的子类型可行，可以多个
     不行的：
         (1)不同的异常类型，不可以多声明
         (2)异常的父类型不行

finally:

    是为try-catch提供了同一的出口，不管try与catch语句块是否发生了异常，最终都会执行finally里的代码。
    通常用于处理一些资源的关闭等操作：如读取文件时关闭操作，或者是删除临时文件。
    finally语句块可有可无。
    当try的逻辑块中有return时，逻辑执行到return处,先将变量的值悬挂，然后执行
     finally语句，最后返回原来悬挂的值。 

finally中的return会覆盖try与ctach中的return！！finally中抛出异常会覆盖try与catch的异常！！因此建议：

• 不要在fianlly中使用return。
• 不要在finally中抛出异常。
• 减轻finally的任务，不要在finally中做一些其它的事情，finally块仅仅用来释放资源是最合适的。
• 将尽量将所有的return写在函数的最后面，而不是try … catch … finally中。