快捷導(dǎo)航

Java后端實(shí)現(xiàn)短鏈接生成功能

更新時(shí)間：2025年03月08日 08:26:32 作者：酥骨魚

短鏈接生成主要在于把指定的接口和參數(shù)實(shí)現(xiàn)加密生成比較短的字符串,再進(jìn)行拼接通過指定的域名或者ip實(shí)現(xiàn)鏈接的跳轉(zhuǎn),下面我們來看看如何使用Java實(shí)現(xiàn)這一功能吧

生成的邏輯

短鏈接生成的核心邏輯主要包括接收長鏈接輸入、生成唯一的短碼、存儲(chǔ)映射關(guān)系以及生成短鏈接。然后，通過重定向機(jī)制實(shí)現(xiàn)短鏈接的訪問跳轉(zhuǎn)。為了保證系統(tǒng)的性能，短鏈接服務(wù)會(huì)涉及哈希算法、數(shù)據(jù)庫存儲(chǔ)優(yōu)化和緩存等技術(shù)。

短鏈接生成主要在于把指定的接口和參數(shù)實(shí)現(xiàn)加密生成比較短的字符串（這里注意一點(diǎn)不要加入中文去生成，加入中文會(huì)提示異常），再進(jìn)行拼接通過指定的域名或者ip實(shí)現(xiàn)鏈接的跳轉(zhuǎn)，如：http://你的域名活ip地址<加密后的字符> 就像 http://127.0.0.1:9001/37kRU 這樣，請求的時(shí)候會(huì)去匹配指定的接口再通過重定向去找到對應(yīng)的地址

實(shí)現(xiàn)目的

Java短鏈接服務(wù)是一個(gè)基于Java編程語言開發(fā)的應(yīng)用程序，能夠?qū)㈤L網(wǎng)址轉(zhuǎn)換為短網(wǎng)址。它的主要作用包括：

URL縮短：將用戶提供的長網(wǎng)址轉(zhuǎn)換為簡短、易于分享的鏈接。通常，長網(wǎng)址包含大量無意義的字符，縮短后便于在社交媒體、短信等平臺上快速分享。例如，將 www.example.com/some/very/l… 轉(zhuǎn)換為 short.ly/abc123
節(jié)省空間：短網(wǎng)址比長網(wǎng)址占用更少的字符，適合字符數(shù)有限制的平臺（如短信）或者需要在有限空間內(nèi)展示鏈接的場合
跟蹤和分析：通過生成的短鏈接，可以進(jìn)行訪問統(tǒng)計(jì)與分析，跟蹤短鏈接被點(diǎn)擊的次數(shù)、用戶來源、地理位置等數(shù)據(jù)。這有助于了解用戶行為、市場趨勢等
優(yōu)化用戶體驗(yàn)：提供簡潔的鏈接，用戶更容易記住并分享，尤其是在電子郵件、廣告、文檔等地方
提高鏈接安全性：短鏈接服務(wù)可以進(jìn)行重定向管理，確保用戶訪問的是正確和安全的目標(biāo)網(wǎng)址，避免惡意重定向和釣魚攻擊
鏈接有效期管理：有些短鏈接服務(wù)允許設(shè)置鏈接的有效期，鏈接在過期后將不再有效，增強(qiáng)了鏈接的管理性和控制性

首先引入依賴

使用SpringBoot項(xiàng)目構(gòu)建

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
    <groupId>cn.hutool</groupId>
    <artifactId>hutool-all</artifactId>
    <version>5.8.31</version>
</dependency>

實(shí)現(xiàn)短鏈接服務(wù)

新增短鏈接工具類

復(fù)制其他博主工具類，也可自己實(shí)現(xiàn)，主要在于加命生成短地址

package com.boot.utils;

import cn.hutool.core.lang.hash.MurmurHash;

/**
 * @date: 2025/3/7 15:32
 * @description: 生成短鏈接的工具類
 */
public class HashUtils {

    private static char[] CHARS = new char[]{
            '0', '1', '2', '3', '4', '5', '6', '7', '8', '9',
            'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', 'K', 'L', 'M', 'N', 'O', 'P', 'Q', 'R', 'S', 'T', 'U', 'V', 'W', 'X', 'Y', 'Z',
            'a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i', 'j', 'k', 'l', 'm', 'n', 'o', 'p', 'q', 'r', 's', 't', 'u', 'v', 'w', 'x', 'y', 'z'
    };
    private static int SIZE = CHARS.length;

    private static String convertDecToBase62(long num) {
        StringBuilder sb = new StringBuilder();
        while (num > 0) {
            int i = (int) (num % SIZE);
            sb.append(CHARS[i]);
            num /= SIZE;
        }
        return sb.reverse().toString();
    }

    public static String hashToBase62(String str) {
        int i = MurmurHash.hash32(str);
        long num = i < 0 ? Integer.MAX_VALUE - (long) i : i;
        return convertDecToBase62(num);
    }
}

新增短鏈接生成地址和訪問地址

package com.boot.controller;

import com.boot.utils.HashUtils;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.*;

import java.util.HashMap;
import java.util.Map;

/**
 * @author: Re
 * @date: 2025/3/7 15:34
 * @description: 必須描述類做什么事情, 實(shí)現(xiàn)什么功能
 */
@Controller
public class UrlController {

		/**
     * 存儲(chǔ)長鏈接和短鏈接的映射關(guān)系（亦可存儲(chǔ)在其他中間件中，如：Redis，MySQL等）
     */
    private static Map<String, String> URL_MAP = new HashMap<>();

    /**
     * 生成短鏈接
     * @param longUrl
     */
    @PostMapping("/generate")
    @ResponseBody
    public String generate(@RequestParam String longUrl) {
        String shortUrl = HashUtils.hashToBase62(longUrl);
        URL_MAP.put(shortUrl, longUrl);
        return shortUrl;
    }

    /**
     * 短鏈接點(diǎn)擊跳轉(zhuǎn)
     * @param shortURL
     */
    @GetMapping("/{shortURL}")
    public String redirect(@PathVariable String shortURL) {
        if (URL_MAP.containsKey(shortURL)) {
            return "redirect:" + URL_MAP.get(shortURL);
        } else {
            return "redirect:/";
        }
    }

    /**
     * 發(fā)送郵件
     */
    @GetMapping("/sendMeg")
    @ResponseBody
    public String sendMeg(String email, String msg){
        return "發(fā)送成功:" + email + ":" + msg;
    }
}

1.先生成短鏈接

2.訪問后端地址ip+加密字符，這里為：http://127.0.0.1:9001/s37kRU3.在瀏覽器請求后會(huì)自動(dòng)跳轉(zhuǎn)輸出如下截圖內(nèi)容

至此短鏈接生成和訪問都能正常使用，其中生成內(nèi)容和對應(yīng)的接口則需要根據(jù)自己的需求去設(shè)定。

注意點(diǎn)

在使用本案例生成短鏈接和訪問短鏈接時(shí)，需要注意控制層注解是否是`@Controller`或者`@RestController`

這兩個(gè)注解對應(yīng)的訪問短鏈接跳轉(zhuǎn)是不一樣的，原因如下：

@RestController 中使用返回字符串 "redirect:" 不起作用，那是因?yàn)?@RestController 默認(rèn)是返回?cái)?shù)據(jù)的響應(yīng)而非視圖，所以 Spring 并不會(huì)像在 @Controller 中那樣處理 "redirect:" 語法，所以當(dāng)使用的是@RestController注解控制層時(shí)，跳轉(zhuǎn)接口需進(jìn)行改造，解決方案如下：

@RestController
public class UrlController {

	/**
     * 你的跳轉(zhuǎn)地址ip或者域名
     */
    private final String BASE_URL = "http://127.0.0.1:9001/";
	/**
     * 存儲(chǔ)長鏈接和短鏈接的映射關(guān)系
     */
    private static Map<String, String> URL_MAP = new HashMap<>();

    /**
     * 生成短鏈接
     * @param longUrl
     */
    @PostMapping("/generate")
    public String generate(@RequestParam String longUrl) {
        String shortUrl = HashUtils.hashToBase62(longUrl);
        URL_MAP.put(shortUrl, BASE_URL + longUrl);
        return shortUrl;
    }

    /**
     * 短鏈接點(diǎn)擊跳轉(zhuǎn)
     * @param shortURL
     */
    @GetMapping("/{shortURL}")
    public void redirect(@PathVariable String shortURL, HttpServletResponse response) throws IOException {
        if (URL_MAP.containsKey(shortURL)) {
            response.sendRedirect(URL_MAP.get(shortURL));
        } else {
            response.sendRedirect("/");
        }
    }

    /**
     * 發(fā)送郵件
     */
    @PostMapping("/sendMeg")
    public String sendMeg(String email, String msg){
        return "發(fā)送成功:" + email + ":" + msg;
    }
}

如果不改造的會(huì)直接輸出：redirect:http://127.0.0.1:9001/sendMeg?email=2281077633@qq.com&msg=123456 就是因?yàn)?code>@RestController不能進(jìn)行視圖解析

結(jié)論：