Golang解析文档对象标识符(DOI)插件库使用指南

DOI (Digital Object Identifier) 是一种用于永久标识和链接数字对象的系统。在Go语言中，可以使用github.com/caltechlibrary/doi库来处理DOI标识符。

安装doi库

首先需要安装doi库：

go get github.com/caltechlibrary/doi

基本使用方法

1. 解析DOI字符串

package main

import (
	"fmt"
	"log"
	
	"github.com/caltechlibrary/doi"
)

func main() {
	// 解析DOI字符串
	d, err := doi.Parse("10.1000/182")
	if err != nil {
		log.Fatal(err)
	}
	
	fmt.Printf("DOI: %s\n", d.String())       // 输出: 10.1000/182
	fmt.Printf("前缀: %s\n", d.Prefix)       // 输出: 10.1000
	fmt.Printf("后缀: %s\n", d.Suffix)       // 输出: 182
	fmt.Printf("URL: %s\n", d.URL())        // 输出: https://doi.org/10.1000/182
	fmt.Printf("是否有效: %v\n", d.IsValid()) // 输出: true
}

2. 验证DOI格式

func validateDOI(doiStr string) {
	d, err := doi.Parse(doiStr)
	if err != nil {
		fmt.Printf("%s 是无效的DOI: %v\n", doiStr, err)
		return
	}
	
	if d.IsValid() {
		fmt.Printf("%s 是有效的DOI\n", doiStr)
	} else {
		fmt.Printf("%s 是无效的DOI\n", doiStr)
	}
}

func main() {
	validateDOI("10.1000/182")      // 有效的
	validateDOI("10.1038/nature123") // 有效的
	validateDOI("10.1234")          // 无效的(缺少后缀)
	validateDOI("abc.123/xyz")      // 无效的(前缀格式错误)
}

3. 从URL中提取DOI

func extractDOIFromURL(urlStr string) {
	d, err := doi.ExtractFromURL(urlStr)
	if err != nil {
		fmt.Printf("无法从URL中提取DOI: %v\n", err)
		return
	}
	
	fmt.Printf("从URL中提取的DOI: %s\n", d.String())
}

func main() {
	extractDOIFromURL("https://doi.org/10.1000/182")
	extractDOIFromURL("http://dx.doi.org/10.1038/nature123")
	extractDOIFromURL("https://example.com/not-a-doi")
}

4. 规范化DOI

func normalizeDOI(doiStr string) {
	d, err := doi.Parse(doiStr)
	if err != nil {
		fmt.Printf("无法解析DOI: %v\n", err)
		return
	}
	
	fmt.Printf("原始: %s\n规范化: %s\n", doiStr, d.Normalize())
}

func main() {
	normalizeDOI("doi:10.1000/182")  // 输出: 10.1000/182
	normalizeDOI("10.1000/182 ")     // 输出: 10.1000/182 (去除空格)
	normalizeDOI("DOI:10.1000/182")  // 输出: 10.1000/182
}

高级功能

1. 批量处理DOI

func processDOIs(dois []string) {
	for _, doiStr := range dois {
		d, err := doi.Parse(doiStr)
		if err != nil {
			fmt.Printf("跳过无效的DOI %s: %v\n", doiStr, err)
			continue
		}
		
		fmt.Printf("处理DOI: %s\n", d.String())
		fmt.Printf("- 前缀: %s\n", d.Prefix)
		fmt.Printf("- 后缀: %s\n", d.Suffix)
		fmt.Printf("- URL: %s\n", d.URL())
		fmt.Println("---")
	}
}

func main() {
	doiList := []string{
		"10.1000/182",
		"10.1038/nature123",
		"invalid.doi",
		"10.1234/567.890",
	}
	
	processDOIs(doiList)
}

2. 创建DOI解析中间件

package main

import (
	"fmt"
	"net/http"
	
	"github.com/caltechlibrary/doi"
)

func doiMiddleware(next http.Handler) http.Handler {
	return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
		// 从查询参数中获取DOI
		doiStr := r.URL.Query().Get("doi")
		if doiStr != "" {
			d, err := doi.Parse(doiStr)
			if err == nil && d.IsValid() {
				// 将解析后的DOI对象存入上下文
				ctx := context.WithValue(r.Context(), "doi", d)
				r = r.WithContext(ctx)
			}
		}
		next.ServeHTTP(w, r)
	})
}

func doiHandler(w http.ResponseWriter, r *http.Request) {
	// 从上下文中获取DOI
	if d, ok := r.Context().Value("doi").(*doi.DOI); ok {
		fmt.Fprintf(w, "DOI信息:\n")
		fmt.Fprintf(w, "- 完整DOI: %s\n", d.String())
		fmt.Fprintf(w, "- 前缀: %s\n", d.Prefix)
		fmt.Fprintf(w, "- 后缀: %s\n", d.Suffix)
		fmt.Fprintf(w, "- URL: %s\n", d.URL())
	} else {
		fmt.Fprintf(w, "未提供有效的DOI参数")
	}
}

func main() {
	mux := http.NewServeMux()
	mux.HandleFunc("/doi", doiHandler)
	
	wrappedMux := doiMiddleware(mux)
	
	fmt.Println("服务器启动，访问 http://localhost:8080/doi?doi=10.1000/182")
	http.ListenAndServe(":8080", wrappedMux)
}

注意事项

1. DOI前缀总是以"10."开头
2. DOI不区分大小写，但通常以小写形式存储
3. 有效的DOI必须包含前缀和后缀，用"/"分隔
4. 该库会自动处理DOI字符串中的常见变体(如"doi:"前缀、多余空格等)

通过使用github.com/caltechlibrary/doi库，您可以轻松地在Go应用程序中解析、验证和处理DOI标识符，这对于学术引用、文献管理等应用场景非常有用。