JPostal 开源项目教程

JPostal 开源项目教程

jpostalJava/JNI bindings to libpostal for for fast international street address parsing/normalization项目地址:https://gitcode.com/gh_mirrors/jp/jpostal

1. 项目的目录结构及介绍

JPostal 项目的目录结构如下：

jpostal/
├── src/
│   ├── main/
│   │   ├── java/
│   │   │   └── com/
│   │   │       └── mapzen/
│   │   │           └── jpostal/
│   │   │               ├── AddressExpander.java
│   │   │               ├── AddressParser.java
│   │   │               └── ...
│   │   └── resources/
│   │       └── ...
│   └── test/
│       ├── java/
│       │   └── com/
│       │       └── mapzen/
│       │           └── jpostal/
│       │               └── ...
│       └── resources/
│           └── ...
├── gradle/
│   └── wrapper/
│       ├── gradle-wrapper.jar
│       └── gradle-wrapper.properties
├── build.gradle
├── settings.gradle
├── LICENSE
├── README.md
└── ...

目录结构介绍

• src/main/java/com/mapzen/jpostal/：包含项目的主要 Java 源代码文件，如 AddressExpander.java 和 AddressParser.java。
• src/main/resources/：包含项目的主要资源文件。
• src/test/java/com/mapzen/jpostal/：包含项目的测试 Java 源代码文件。
• src/test/resources/：包含项目的测试资源文件。
• gradle/wrapper/：包含 Gradle 包装器文件，用于确保项目使用特定版本的 Gradle。
• build.gradle：Gradle 构建文件，包含项目的构建配置。
• settings.gradle：Gradle 设置文件，包含项目的模块和仓库配置。
• LICENSE：项目的许可证文件。
• README.md：项目的自述文件，包含项目的基本信息和使用说明。

2. 项目的启动文件介绍

项目的启动文件主要是 AddressExpander.java 和 AddressParser.java，它们位于 src/main/java/com/mapzen/jpostal/ 目录下。

AddressExpander.java

AddressExpander.java 文件负责地址扩展功能，将地址字符串扩展为标准化形式。

import com.mapzen.jpostal.AddressExpander;

public class Main {
    public static void main(String[] args) {
        AddressExpander e = AddressExpander.getInstance();
        String[] expansions = e.expandAddress("Quatre vingt douze Ave des Champs-Élysées");
        for (String expansion : expansions) {
            System.out.println(expansion);
        }
    }
}

AddressParser.java

AddressParser.java 文件负责地址解析功能，将地址字符串解析为各个组件。

import com.mapzen.jpostal.AddressParser;

public class Main {
    public static void main(String[] args) {
        AddressParser p = AddressParser.getInstance();
        Map<String, String> components = p.parseAddress("123 Main St, New York, NY 10030");
        for (Map.Entry<String, String> entry : components.entrySet()) {
            System.out.println(entry.getKey() + ": " + entry.getValue());
        }
    }
}

3. 项目的配置文件介绍

项目的配置文件主要是 build.gradle 和 settings.gradle。

build.gradle

build.gradle 文件包含项目的构建配置，如依赖管理、任务定义等。

plugins {
    id 'java'
}

group 'com.mapzen'
version '1.0-SNAPSHOT'

repositories {
    mavenCentral()
}

dependencies {
    testImplementation 'junit:junit:4.12'
    implementation 'com.mapzen.jpostal:jpostal:1.0.0'
}

settings.gradle

settings.gradle 文件包含项目的模块和仓库配置。

rootProject.name = 'jpostal'

以上是 JPostal 开源项目的教程，涵盖

jpostalJava/JNI bindings to libpostal for for fast international street address parsing/normalization项目地址:https://gitcode.com/gh_mirrors/jp/jpostal