spring 之资源操作：Resources

public interface Resource extends InputStreamSource {

    /**
     * 判断资源是否物理存在。
     * 这个方法进行确切的存在性检查，而资源的存在只保证了有效的描述符。
     */
    boolean exists();

    /**
     * 指示是否可以通过 {@link #getInputStream()} 读取此资源的非空内容。
     * 通常对于存在的典型资源描述符，返回 {@code true}，因为它严格隐含了 {@link #exists()} 的语义。
     * 注意，实际的内容读取可能仍然会失败。然而，{@code false} 明确指出资源内容无法读取。
     */
    default boolean isReadable() {
        return exists();
    }

    /**
     * 指示此资源是否代表一个开放的流句柄。
     * 如果为 {@code true}，InputStream 不能被多次读取，并且必须在读取后及时关闭以避免资源泄漏。
     * 对于典型的资源描述符，这将是 {@code false}。
     */
    default boolean isOpen() {
        return false;
    }

    /**
     * 判断此资源是否代表文件系统中的一个文件。
     * {@code true} 值强烈暗示（但不保证）{@link #getFile()} 调用会成功。
     * 默认情况下，这是保守地设置为 {@code false}。
     */
    default boolean isFile() {
        return false;
    }

    /**
     * 返回此资源的 URL 句柄。
     * @throws IOException 如果资源无法作为 URL 解析，即如果资源作为描述符不可用。
     */
    URL getURL() throws IOException;

    /**
     * 返回此资源的 URI 句柄。
     * @throws IOException 如果资源无法作为 URI 解析，即如果资源作为描述符不可用。
     */
    URI getURI() throws IOException;

    /**
     * 返回此资源的文件句柄。
     * @throws java.io.FileNotFoundException 如果资源无法解析为绝对文件路径，即如果资源在文件系统中不可用。
     * @throws IOException 如果在解析/读取时发生一般性故障。
     */
    File getFile() throws IOException;

    /**
     * 返回一个 {@link ReadableByteChannel}。
     * 预期每次调用都会创建一个新的通道。
     * 默认实现通过 {@link #getInputStream()} 的结果返回 {@link Channels#newChannel(InputStream)}。
     * @return 此资源底层的字节通道（不能为空）。
     * @throws java.io.FileNotFoundException 如果底层资源不存在。
     * @throws IOException 如果无法打开内容通道。
     */
    default ReadableByteChannel readableChannel() throws IOException {
        return Channels.newChannel(getInputStream());
    }

    /**
     * 将此资源的内容作为字节数组返回。
     * @return 此资源的内容作为字节数组。
     * @throws java.io.FileNotFoundException 如果资源无法解析为绝对文件路径，即如果资源在文件系统中不可用。
     * @throws IOException 如果在解析/读取时发生一般性故障。
     */
    default byte[] getContentAsByteArray() throws IOException {
        return FileCopyUtils.copyToByteArray(getInputStream());
    }

    /**
     * 使用指定的字符集，将此资源的内容作为字符串返回。
     * @param charset 用于解码的字符集。
     * @return 此资源的内容作为一个 {@code String}。
     * @throws java.io.FileNotFoundException 如果资源无法解析为绝对文件路径，即如果资源在文件系统中不可用。
     * @throws IOException 如果在解析/读取时发生一般性故障。
     */
    default String getContentAsString(Charset charset) throws IOException {
        return FileCopyUtils.copyToString(new InputStreamReader(getInputStream(), charset));
    }

    /**
     * 确定此资源的内容长度。
     * @throws IOException 如果无法解析资源（在文件系统或作为其他已知的物理资源类型）。
     */
    long contentLength() throws IOException;

    /**
     * 确定此资源最后修改的时间戳。
     * @throws IOException 如果无法解析资源（在文件系统或作为其他已知的物理资源类型）。
     */
    long lastModified() throws IOException;

    /**
     * 创建相对于此资源的相对路径资源。
     * @param relativePath 相对于此资源的相对路径。
     * @return 相对资源的资源句柄。
     * @throws IOException 如果无法确定相对资源。
     */
    Resource createRelative(String relativePath) throws IOException;

    /**
     * 确定此资源的文件名 - 通常是路径的最后一部分 - 例如，{@code "myfile.txt"}。
     * 如果此类资源没有文件名，则返回 {@code null}。
     * 鼓励实现返回未编码的文件名。
     */
    @Nullable
    String getFilename();

    /**
     * 返回此资源的描述，用于在使用资源时输出错误信息。
     * 鼓励实现也从他们的 {@code toString} 方法返回这个值。
     * @see Object#toString()
     */
    String getDescription();

}

public interface InputStreamSource {

    InputStream getInputStream() throws IOException;

}

import org.springframework.core.io.UrlResource;

/**
 * UrlResource访问资源
 *
 * @author 阿杰 2416338031@qq.com
 * @version 1.0
 * @date 2024/1/2 7:13
 */
public class UrlResourceTest {

    /**
     * 通过UrlResource访问网络资源
     *
     * @param path 资源路径
     */
    public static void loadAndReadUrlResource(String path) {
        // 创建一个 Resource 对象
        UrlResource url = null;
        try {
            url = new UrlResource(path);
            // 获取资源名
            System.out.println("资源名:" + url.getFilename());
            System.out.println("资源路径:" + url.getURL());
            // 获取资源描述
            System.out.println("资源描述:" + url.getDescription());
            //获取资源内容
            System.out.println("资源内容:" + url.getInputStream().read());
        } catch (Exception e) {
            throw new RuntimeException(e);
        }
    }

    public static void main(String[] args) {
        loadAndReadUrlResource("https://www.baidu.com");
    }

}

import org.springframework.core.io.ClassPathResource;

import java.io.InputStream;

/**
 * 访问类路径下的资源演示
 *
 * @author 阿杰 2416338031@qq.com
 * @version 1.0
 * @date 2024/1/2 7:31
 */
public class ClassPathResourceTest {

    /**
     * 通过ClassPathResource访问类路径下的资源
     *
     * @param path 资源路径
     */
    public static void loadAndReadUrlResource(String path) throws Exception {
        // 创建一个 Resource 对象
        ClassPathResource resource = new ClassPathResource(path);
        // 获取文件名
        System.out.println("resource.getFileName = " + resource.getFilename());
        // 获取文件描述
        System.out.println("resource.getDescription = " + resource.getDescription());
        //获取文件内容
        InputStream in = resource.getInputStream();
        byte[] b = new byte[1024];
        while (in.read(b) != -1) {
            System.out.println(new String(b));
        }
    }

    public static void main(String[] args) throws Exception {
        loadAndReadUrlResource("提示词.txt");
    }
}

import org.springframework.core.io.FileSystemResource;

import java.io.InputStream;

/**
 *  使用FileSystemResource 访问文件系统资源
 *
 * @author 阿杰 2416338031@qq.com
 * @version 1.0
 * @date 2024/1/2 7:38
 */
public class FileSystemResourceTest {


    /**
     * 通过FileSystemResource访问文件系统资源
     *
     * @param path 资源路径
     */
    public static void loadAndReadUrlResource(String path) throws Exception{
        FileSystemResource resource = new FileSystemResource(path);
        // 获取文件名
        System.out.println("resource.getFileName = " + resource.getFilename());
        // 获取文件描述
        System.out.println("resource.getDescription = "+ resource.getDescription());
        //获取文件内容
        InputStream in = resource.getInputStream();
        byte[] b = new byte[1024];
        while(in.read(b)!=-1) {
            System.out.println(new String(b));
        }
    }

    public static void main(String[] args) throws Exception {
        // 访问文件系统资源 相对路径
        loadAndReadUrlResource("pom.xml");

        // 访问文件系统资源 绝对路径
        loadAndReadUrlResource("D:\\code\\Java\\spring6-learning-project\\pom.xml");
    }
}

import org.springframework.context.ApplicationContext;
import org.springframework.context.support.ClassPathXmlApplicationContext;
import org.springframework.core.io.Resource;

public class ResourceExample {
    public static void main(String[] args) {
        // 访问类路径下的资源
        ApplicationContext ctx = new ClassPathXmlApplicationContext();
        // 获取类路径下的资源
        Resource res = ctx.getResource("提示词.txt");
        // 输出资源信息
        System.out.println(res.getFilename());
    }
}

import org.springframework.context.ApplicationContext;
import org.springframework.context.support.FileSystemXmlApplicationContext;
import org.springframework.core.io.Resource;

public class ResourceExample {
    public static void main(String[] args) {
        // 访问类路径下的资源
        ApplicationContext ctx = new FileSystemXmlApplicationContext();
        // 获取类路径下的资源
        Resource res = ctx.getResource("提示词.txt");
        // 输出资源信息
        System.out.println(res.getFilename());
    }
}

Resource res = ctx.getResource("classpath:bean.xml");
Resource res = ctx.getResource("file:bean.xml");
Resource res = ctx.getResource("http://localhost:8080/beans.xml");

package com.jie.resource;


import org.springframework.context.ResourceLoaderAware;
import org.springframework.core.io.ResourceLoader;

/**
 * 实现ResourceLoaderAware接口，获取ResourceLoader对象
 *
 * @author 阿杰 2416338031@qq.com
 * @version 1.0
 * @date 2024/1/2 20:52
 */
public class TestBean implements ResourceLoaderAware {

    /**
     * ResourceLoader对象
     */
    private ResourceLoader resourceLoader;

    /**
     * 实现ResourceLoaderAware接口必须实现的方法
     * 如果把该Bean部署在Spring容器中，该方法将会有Spring容器负责调用。
     * SPring容器调用该方法时，Spring会将自身作为参数传给该方法。
     *
     * @param resourceLoader ResourceLoader对象
     */
    public void setResourceLoader(ResourceLoader resourceLoader) {
        // 将ResourceLoader对象保存起来
        this.resourceLoader = resourceLoader;
    }

    /**
     * 获取ResourceLoader对象
     *
     * @return ResourceLoader对象
     */
    public ResourceLoader getResourceLoader() {
        // 返回ResourceLoader对象
        return this.resourceLoader;
    }
}

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd">

    <!-- 通过classpath:来指定资源的位置 -->
    <bean id="testBean" class="com.jie.resource.TestBean"/>
</beans>

import com.jie.resource.TestBean;
import org.springframework.context.ApplicationContext;
import org.springframework.context.support.ClassPathXmlApplicationContext;
import org.springframework.core.io.Resource;
import org.springframework.core.io.ResourceLoader;

public class ResourceExample {
    public static void main(String[] args) {
        // Spring容器会将一个ResourceLoader对象作为该方法的参数传入
        ApplicationContext ctx = new ClassPathXmlApplicationContext("bean.xml");
        // 获取TestBean对象
        TestBean testBean = ctx.getBean("testBean", TestBean.class);
        // 获取ResourceLoader对象
        ResourceLoader resourceLoader = testBean.getResourceLoader();
        // 判断ResourceLoader对象是否是Spring容器本身
        System.out.println("Spring容器将自身注入到ResourceLoaderAware Bean 中 ？ ：" + (resourceLoader == ctx));
        // 获取Resource对象
        Resource resource = resourceLoader.getResource("提示词.txt");
        // 输出Resource对象的文件名
        System.out.println(resource.getFilename());
        // 输出Resource对象的描述信息
        System.out.println(resource.getDescription());
    }
}

package com.jie.resource;

import org.springframework.core.io.Resource;

/**
 * ResourceBean
 *
 * @author 阿杰 2416338031@qq.com
 * @version 1.0
 * @date 2024/1/2 21:03
 */
public class ResourceBean {


    /**
     * Resource对象
     */
    private Resource res;

    /**
     * 设置Resource对象
     *
     * @param res Resource对象
     */
    public void setRes(Resource res) {
        this.res = res;
    }

    /**
     * 获取Resource对象
     *
     * @return Resource对象
     */
    public Resource getRes() {
        return res;
    }

    /**
     * 解析Resource对象
     */
    public void parse() {
        System.out.println(res.getFilename());
        System.out.println(res.getDescription());
    }
}

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd">

    <!-- 通过classpath:来指定资源的位置 -->
    <bean id="resourceBean" class="com.jie.resource.ResourceBean">
        <!-- 可以使用file:、http:、ftp:等前缀强制Spring采用对应的资源访问策略 -->
        <!-- 如果不采用任何前缀，则Spring将采用与该ApplicationContext相同的资源访问策略来访问资源 -->
        <property name="res" value="classpath:提示词.txt"/>
    </bean>
</beans>

import com.jie.resource.ResourceBean;
import org.springframework.context.ApplicationContext;
import org.springframework.context.support.ClassPathXmlApplicationContext;

public class ResourceExample {
    public static void main(String[] args) {
        // 通过类路径加载配置文件
        ApplicationContext ctx = new ClassPathXmlApplicationContext("bean2.xml");
        // 获取ResourceBean对象
        ResourceBean resourceBean = ctx.getBean("resourceBean", ResourceBean.class);
        // 调用ResourceBean的parse方法
        resourceBean.parse();
    }
}

package com.atguigu.spring6.context;

import org.springframework.context.ApplicationContext;
import org.springframework.context.support.ClassPathXmlApplicationContext;
import org.springframework.core.io.Resource;

public class Demo1 {

    public static void main(String[] args) {
        /*
         * 通过搜索文件系统路径下的xml文件创建ApplicationContext，
         * 但通过指定classpath:前缀强制搜索类加载路径
         * classpath:bean.xml
         * */
        ApplicationContext ctx =
                new ClassPathXmlApplicationContext("classpath:bean.xml");
        System.out.println(ctx);
        Resource resource = ctx.getResource("atguigu.txt");
        System.out.println(resource.getFilename());
        System.out.println(resource.getDescription());
    }
}

ApplicationContext ctx = new ClassPathXmlApplicationContext("classpath*:bean.xml");
System.out.println(ctx);

ApplicationContext ctx = new ClassPathXmlApplicationContext("classpath:bean*.xml");

ApplicationContext ctx = new ClassPathXmlApplicationContext("classpath*:bean*.xml");