使用svnkit对svn新增代码统计、代码查询

最新推荐文章于 2024-05-24 14:46:56 发布
最新推荐文章于 2024-05-24 14:46:56 发布
阅读量5.2k 收藏 7
点赞数
分类专栏： java 文章标签： svnkit java 代码统计
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/u012621115/article/details/52936222
版权

引入包：svnkit

https://mvnrepository.com/artifact/org.tmatesoft.svnkit/svnkit

<!-- https://mvnrepository.com/artifact/org.tmatesoft.svnkit/svnkit -->
<dependency>
    <groupId>org.tmatesoft.svnkit</groupId>
    <artifactId>svnkit</artifactId>
    <version>1.8.14</version>
</dependency>

代码demo

package com.yy.svn;

import java.io.BufferedReader;
import java.io.ByteArrayOutputStream;
import java.io.File;
import java.io.FileOutputStream;
import java.io.FileReader;
import java.io.IOException;
import java.io.OutputStream;
import java.nio.charset.Charset;
import java.util.ArrayList;
import java.util.Collection;
import java.util.Date;
import java.util.List;
import java.util.Map;
import java.util.Random;
import java.util.Set;

import org.tmatesoft.svn.core.ISVNLogEntryHandler;
import org.tmatesoft.svn.core.SVNDirEntry;
import org.tmatesoft.svn.core.SVNException;
import org.tmatesoft.svn.core.SVNLogEntry;
import org.tmatesoft.svn.core.SVNLogEntryPath;
import org.tmatesoft.svn.core.SVNNodeKind;
import org.tmatesoft.svn.core.SVNProperties;
import org.tmatesoft.svn.core.SVNURL;
import org.tmatesoft.svn.core.auth.ISVNAuthenticationManager;
import org.tmatesoft.svn.core.internal.wc.DefaultSVNOptions;
import org.tmatesoft.svn.core.io.SVNRepository;
import org.tmatesoft.svn.core.io.SVNRepositoryFactory;
import org.tmatesoft.svn.core.wc.SVNDiffClient;
import org.tmatesoft.svn.core.wc.SVNLogClient;
import org.tmatesoft.svn.core.wc.SVNRevision;
import org.tmatesoft.svn.core.wc.SVNWCUtil;


public class SvnkitDemo {
	
	private String userName = "user";
	private String password = "password";
	private String urlString = "svn url";
	boolean readonly = true;
	private String tempDir = System.getProperty("java.io.tmpdir");
	private DefaultSVNOptions options = SVNWCUtil.createDefaultOptions( readonly );
	private Random random = new Random();
	
	private SVNRepository repos;
	private ISVNAuthenticationManager authManager;
	
	
	
	public SvnkitDemo() {
		try {
			init();
		} catch (SVNException e) {
			// TODO Auto-generated catch block
			e.printStackTrace();
		}
	}

	public void init() throws SVNException{
		ISVNAuthenticationManager authManager = SVNWCUtil.createDefaultAuthenticationManager(new File(tempDir+"/auth"), userName, password.toCharArray());
		options.setDiffCommand("-x -w");
		repos = SVNRepositoryFactory.create(SVNURL
                .parseURIEncoded(urlString));
		repos.setAuthenticationManager(authManager);
		System.out.println("init completed");
	}
	
	/**获取一段时间内，所有的commit记录
	 * @param st	开始时间
	 * @param et	结束时间
	 * @return
	 * @throws SVNException
	 */
	public SVNLogEntry[] getLogByTime(Date st, Date et) throws SVNException{
		long startRevision = repos.getDatedRevision(st);
        long endRevision = repos.getDatedRevision(et);
        
        @SuppressWarnings("unchecked")
		Collection<SVNLogEntry> logEntries = repos.log(new String[]{""}, null,
                startRevision, endRevision, true, true);
        SVNLogEntry[] svnLogEntries = logEntries.toArray(new SVNLogEntry[0]);
        return svnLogEntries;
	}
	
	/**获取版本比较日志，并存入临时文件
	 * @param startVersion
	 * @param endVersion
	 * @return
	 * @throws SVNException
	 * @throws IOException
	 */
	public File getChangeLog(long startVersion, long endVersion) throws SVNException, IOException{
		SVNDiffClient diffClient = new SVNDiffClient(authManager, options);
		diffClient.setGitDiffFormat(true);
		File tempLogFile = null;
		OutputStream outputStream = null;
        String svnDiffFile = null;
        

        do {
        	svnDiffFile = tempDir + "/svn_diff_file_"+startVersion+"_"+endVersion+"_"+random.nextInt(10000)+".txt";
        	tempLogFile = new File(svnDiffFile);
		} while (tempLogFile != null && tempLogFile.exists());
        try {
        	tempLogFile.createNewFile();
	        outputStream = new FileOutputStream(svnDiffFile);
			diffClient.doDiff(SVNURL.parseURIEncoded(urlString),
	                SVNRevision.create(startVersion),
	                SVNURL.parseURIEncoded(urlString),
	                SVNRevision.create(endVersion),
	                org.tmatesoft.svn.core.SVNDepth.UNKNOWN, true, outputStream);
		} catch (Exception e) {
			e.printStackTrace();
		}finally {
			if(outputStream!=null)
				try {
					outputStream.close();
				} catch (IOException e) {
					e.printStackTrace();
				}
		}   
        return tempLogFile;
	}
	
	/**分析变更的代码，统计代码增量
     * @param file
     * @return
     * @throws Exception
     */
    public int staticticsCodeAdd(File file) throws Exception{
    	System.out.println("开始统计修改代码行数");
    	FileReader fileReader = new FileReader(file);
		BufferedReader in = new BufferedReader(fileReader);
		int sum = 0;
		String line = null;
		StringBuffer buffer = new StringBuffer(1024);
		boolean start = false;
		while((line=in.readLine()) != null){
			if(line.startsWith("Index:")){
				if(start){
					ChangeFile changeFile = parseChangeFile(buffer);
					int oneSize = staticOneFileChange(changeFile);
					System.out.println("filePath="+changeFile.getFilePath()+"  changeType="+changeFile.getChangeType()+"  addLines="+oneSize);
					sum += oneSize;
					buffer.setLength(0);
				}
				start = true;
			}
			buffer.append(line).append('\n');
		}
		if(buffer.length() > 0){
			ChangeFile changeFile = parseChangeFile(buffer);
			int oneSize = staticOneFileChange(changeFile);
			System.out.println("filePath="+changeFile.getFilePath()+"  changeType="+changeFile.getChangeType()+"  addLines="+oneSize);
			sum += oneSize;
		}
		in.close();
		fileReader.close();
		boolean deleteFile = file.delete();
		System.out.println("-----delete file-----"+deleteFile);
		return sum;
	}
    
    /**统计单个文件的增加行数，（先通过过滤器，如文件后缀、文件路径等等），也可根据修改类型来统计等，这里只统计增加或者修改的文件
     * @param changeFile
     * @return
     */
    public int staticOneFileChange(ChangeFile changeFile){
    	char changeType = changeFile.getChangeType();
    	if(changeType == 'A'){
    		return countAddLine(changeFile.getFileContent());
    	}else if(changeType == 'M'){
			return countAddLine(changeFile.getFileContent());
		}
    	return 0;
    }
	
	/**解析单个文件变更日志
	 * @param str
	 * @return
	 */
	public ChangeFile parseChangeFile(StringBuffer str){
		int index = str.indexOf("\n@@");
		if(index > 0){
			String header = str.substring(0, index);
			String[] headers = header.split("\n");
			String filePath = headers[0].substring(7);
			char changeType = 'U';
			boolean oldExist = !headers[2].endsWith("(nonexistent)");
			boolean newExist = !headers[3].endsWith("(nonexistent)");
			if(oldExist && !newExist){
				changeType = 'D';
			}else if(!oldExist && newExist){
				changeType = 'A';
			}else if(oldExist && newExist){
				changeType = 'M';
			}
			int bodyIndex = str.indexOf("@@\n")+3;
			String body = str.substring(bodyIndex);
			ChangeFile changeFile = new ChangeFile(filePath, changeType, body);
			return changeFile;
		}else{
			String[] headers = str.toString().split("\n");
			String filePath = headers[0].substring(7);
			ChangeFile changeFile = new ChangeFile(filePath, 'U', null);
			return changeFile;
		}
	}
	
	/**通过比较日志，统计以+号开头的非空行
	 * @param content
	 * @return
	 */
	public int countAddLine(String content){
		int sum = 0;
		if(content !=null){
			content = '\n' + content +'\n';
			char[] chars = content.toCharArray();
			int len = chars.length;
			//判断当前行是否以+号开头
			boolean startPlus = false;
			//判断当前行，是否为空行（忽略第一个字符为加号）
			boolean notSpace = false;
			
			for(int i=0;i<len;i++){
				char ch = chars[i];
				if(ch =='\n'){
					//当当前行是+号开头，同时其它字符都不为空，则行数+1
					if(startPlus && notSpace){
						sum++;
						notSpace = false;
					}
					//为下一行做准备，判断下一行是否以+头
					if(i < len-1 && chars[i+1] == '+'){
						startPlus = true;
						//跳过下一个字符判断，因为已经判断了
						i++;
					}else{
						startPlus = false;
					}
				}else if(startPlus && ch > ' '){//如果当前行以+开头才进行非空行判断
					notSpace = true;
				}
			}
		}
		
		return sum;
	}
	
	/**统计一段时间内代码增加量
	 * @param st
	 * @param et
	 * @return
	 * @throws Exception
	 */
	public int staticticsCodeAddByTime(Date st, Date et) throws Exception{
		int sum = 0;
		SVNLogEntry[] logs = getLogByTime(st, et);
		if(logs.length > 0){
			long lastVersion = logs[0].getRevision()-1;
			for(SVNLogEntry log:logs){
				File logFile = getChangeLog(lastVersion, log.getRevision());
				int addSize = staticticsCodeAdd(logFile);
				sum+=addSize;
				lastVersion = log.getRevision();
				
			}
		}
		return sum;
	}
	
	/**获取某一版本有变动的文件路径
	 * @param version
	 * @return
	 * @throws SVNException
	 */
	public List<SVNLogEntryPath> getChangeFileList(long version) throws SVNException{
		
		List<SVNLogEntryPath> result = new ArrayList<>();
		SVNLogClient logClient = new SVNLogClient( authManager, options );
		SVNURL url = SVNURL.parseURIEncoded(urlString);
		String[] paths = { "." };
		SVNRevision pegRevision = SVNRevision.create( version );
	    SVNRevision startRevision = SVNRevision.create( version );
	    SVNRevision endRevision = SVNRevision.create( version );
		boolean stopOnCopy = false;
	    boolean discoverChangedPaths = true;
	    long limit = 9999l;
		
		ISVNLogEntryHandler handler = new ISVNLogEntryHandler() {

	        /**
	         * This method will process when doLog() is done
	         */
	        @Override
	        public void handleLogEntry( SVNLogEntry logEntry ) throws SVNException {
	            System.out.println( "Author: " + logEntry.getAuthor() );
	            System.out.println( "Date: " + logEntry.getDate() );
	            System.out.println( "Message: " + logEntry.getMessage() );
	            System.out.println( "Revision: " + logEntry.getRevision() );
	            System.out.println("-------------------------");
	            Map<String, SVNLogEntryPath> maps = logEntry.getChangedPaths();
	            Set<Map.Entry<String, SVNLogEntryPath>> entries = maps.entrySet();
	            for(Map.Entry<String, SVNLogEntryPath> entry : entries){
	            	//System.out.println(entry.getKey());
	            	SVNLogEntryPath entryPath = entry.getValue();
	            	result.add(entryPath);
	            	System.out.println(entryPath.getType()+" "+entryPath.getPath());
	            }
	        }
	    };
	 // Do log
	    try {
	        logClient.doLog( url, paths, pegRevision, startRevision, endRevision, stopOnCopy, discoverChangedPaths, limit, handler );
	    }
	    catch ( SVNException e ) {
	        System.out.println( "Error in doLog() " );
	        e.printStackTrace();
	    }
	    return result;
	}
	
	/**获取指定文件内容
	 * @param url	svn地址
	 * @return
	 */
	public String checkoutFileToString(String url){//"", -1, null   
        try {  
            SVNDirEntry entry = repos.getDir("", -1, false, null);  
            int size = (int)entry.getSize();  
            ByteArrayOutputStream outputStream = new ByteArrayOutputStream(size);  
            SVNProperties properties = new SVNProperties();  
            repos.getFile("", -1, properties, outputStream);  
            String doc = new String(outputStream.toByteArray(),Charset.forName("utf-8"));  
            return doc;  
        } catch (SVNException e) {  
            e.printStackTrace();  
        }  
        return null;  
    }
	
	/**列出指定SVN 地址目录下的子目录 
     * @param url 
     * @return 
     * @throws SVNException 
     */  
    public List<SVNDirEntry> listFolder(String url){  
        if(checkPath(url)==1){  
               
            try {  
                Collection<SVNDirEntry> list = repos.getDir("", -1, null, (List<SVNDirEntry>)null);  
                List<SVNDirEntry> dirs = new ArrayList<SVNDirEntry>(list.size());  
                dirs.addAll(list);  
                return dirs;  
            } catch (SVNException e) {  
                e.printStackTrace(); 
            }  
  
        }  
        return null;  
    } 
    
    /**检查路径是否存在 
     * @param url 
     * @return 1：存在    0：不存在   -1：出错 
     */  
    public int checkPath(String url){    
        SVNNodeKind nodeKind;  
        try {  
            nodeKind = repos.checkPath("", -1);  
            boolean result = nodeKind == SVNNodeKind.NONE ? false : true;  
            if(result) return 1;  
        } catch (SVNException e) {  
            e.printStackTrace();
            return -1;  
        }  
        return 0;  
    }
	
	

	public static void main(String[] args) {
		SvnkitDemo demo = new SvnkitDemo();
		Date now = new Date();
		Date twoDayAgo = new Date(now.getTime()-2*24*3600000);
		try {
//			int sum = demo.staticticsCodeAddByTime(now, twoDayAgo);
//			System.out.println("sum="+sum);
			demo.getChangeFileList(487837L);
		} catch (Exception e) {
			// TODO Auto-generated catch block
			e.printStackTrace();
		}

	}

}

class ChangeFile {
	
	private String filePath;
	private String fileType;
	
	/**A表示增加文件，M表示修改文件，D表示删除文件，U表示末知
	 * 
	 */
	private Character changeType;
	private String fileContent;
	
	
	
	
	public ChangeFile() {
	}
	public ChangeFile(String filePath) {
		this.filePath = filePath;
		this.fileType = getFileTypeFromPath(filePath);
	}
	public ChangeFile(String filePath, Character changeType, String fileContent) {
		this.filePath = filePath;
		this.changeType = changeType;
		this.fileContent = fileContent;
		this.fileType = getFileTypeFromPath(filePath);
	}
	public String getFilePath() {
		return filePath;
	}
	public void setFilePath(String filePath) {
		this.filePath = filePath;
	}
	public String getFileType() {
		return fileType;
	}
	public void setFileType(String fileType) {
		this.fileType = fileType;
	}
	public Character getChangeType() {
		return changeType;
	}
	public void setChangeType(Character changeType) {
		this.changeType = changeType;
	}
	public String getFileContent() {
		return fileContent;
	}
	public void setFileContent(String fileContent) {
		this.fileContent = fileContent;
	}
	
    private static String getFileTypeFromPath(String path) {
        String FileType = "";
        int idx = path.lastIndexOf(".");
        if (idx > -1) {
            FileType = path.substring(idx + 1).trim().toLowerCase();
        }
        return FileType;
    }
}



牵手无奈
关注
  • 0
    点赞
  • 踩
  • 7
    收藏
    觉得还不错? 一键收藏
  • 1
    评论
专栏目录
通过svnkit，获取最新的revision以及判断某个revsion是否存在
lizeyang的专栏
05-26 7629
在java下，已经有一个非常强大的工具，svnkit，为我们封装了非常全面的svn操作类。但是，笔者在使用时，就碰到两个问题，还是稍微琢磨了一阵子，才想到解决办法（我使用的是1.x版本的svnkit，不清楚2.x版本的，是否有更直接的方法） 问题1：如何获取指定svn路径的最新revsion 问题2：判断某svn路径下，某个revsion号是否存在 讲这两个问题前，首先要理清Repo
java编写SVN统计代码数量
qq_37773018的博客
06-22 385
public class SVNTongji { //项目路径 private static final String projectPath = "F:\\MyWork\\SVN\\baogaotongji"; //statsvn.jar路径 private static final String statsvnPath = "F:\\statsvn"; //分析报告输出路径 private static final String outputPat.
快速统计SVN代码提交行数
Sunxiaolin2016的博客
05-15 3721
使用java工具：satasvn.jar 工具下载地址：https://sourceforge.net/projects/statsvn/ 前提条件： 1.java环境 2.svn安装时勾选了“命令行功能”并安装。 关于第二个前提条件，一般用户在安装svn软件时，并没有勾选“命令行功能”，所以无法使用svn命令。这种情况下，可以在控制面板–程序–程序和功能–TortoiseSVN 1.11.1.28492(64 bit)中右键选择更改，并继续安装，安装过程中选上“命令行功能”，如下图所示： 使用方法：
java中使用svnkit实现文件的版本管理
最新发布
weixin_42684368的博客
05-24 279
本文主要通过svnkit实现java对svn进行简单的操作，包括svn仓库创建以及版本提交，分支创建等等操作
svn代码行变更统计工具
04-02
NULL 博文链接：https://45121739-163-com.iteye.com/blog/1390144
统计svn上两个版本或一段时间内的代码修改行数
honghailiang的专栏
07-22 4264
http://blog.csdn.net/skygpan/article/details/47749891 有的时候，我们想要统计svn上两个版本或一段时间内的代码修改行数。我们可以通过svn提供的svn diff命令帮助我们解决这个问题。 svn环境 首先，你必须要有一个svn的环境。如果你安装的是TortoiseSVN客户端，那么一定要安装command line client
svn查看本地和库上文件是否有修改
re_call的博客
09-22 4296
查看本地文件是否有变动使用： svn st 如果在文件显示‘M’，表示本地有修改。如果什么不显示，表示没有修改。 查看库上文件是否有变动使用： svn st -qu 如果文件前面有‘*’，表示库上有更新文件，在修改本地文件前，要先更新本地文件。 ...
java实现的svn统计修改代码行数完整源码
08-18
本篇文章将详细介绍一个使用Java编写的工具，该工具能够统计SVN中的代码修改情况。 首先，我们需要理解SVN的工作原理。Subversion是一个分布式版本控制系统，用于管理文件和目录的变更历史。通过记录每个文件的每次...
JAVA编写SVN统计代码数量系统
12-25
【标题】"JAVA编写SVN统计代码数量系统"是一个基于Spring Boot框架的项目，用于统计在Subversion（SVN）版本控制系统中的代码提交情况。它能够详细地分析每个团队成员在SVN仓库中的代码贡献量。 【核心知识点】： ...
java代码利用svnkit操作svn导出某版本或多个版本修改的文件
03-21
利用svnkit操作svn，实现对版本修改文件的导出，可以导出多个版本，.java文件将会在本地取出.class文件，导出后压缩成压缩包，主要用于服务器上的资源更新，不需要开发人员去找到对应的.class文件或其他文件压缩然后...
SVNKit获取SVN信息
03-06
SVNKit获取SVN信息
SVNKittest(SVNKit各种操作demo)
04-30
其他SVNKit的操作包括CheckOut，DoCommit，DoDiff，DoImport，DoUpdate，查看上次备注信息（message/log）,DisplayFile(查看svn文件属性)DisplayRepositoryTree（查看某路径下的所有文件）
java操作svndemo
08-15
java操作svn的demo，官网上下载的，有兴趣的可以看看。
SVNkit的Jar包 和实例代码
02-22
标签“SVN”、“SVNKit”、“SVNjar”和“SVN代码”分别强调了这是与Subversion、SVNkit库、JAR包以及与之相关的代码实现有关的内容。这些标签有助于用户通过关键词搜索找到相关的资料和解决方案。 在压缩包的文件...
java实现svn统计代码修改行数的完整源码
08-18
"java实现svn统计代码修改行数的完整源码"这一标题表明了这是一个使用Java编程语言编写的程序，其主要功能是通过与Subversion（简称SVN）版本控制系统交互，来统计在SVN仓库中代码的修改行数。这涉及到的知识点包括...
svnkit的使用
侠之大者，为国为民
02-04 3189
由于需要用Java代码控制SVN，比方下载SVN的代码，网上找到了大牛直接徒手写的代码，但是后来发现了svnkit这么个东西，直接进入官网可以看到它的例子，由于我得需求比较简单，只需要下载SVN的代码，所以我就直接借鉴了网上现成的代码，加上svnkit的jar包就可以执行了，注意用户名和密码要正确。 package svnkit; import java.io.File; import or
SVNKIT 主要方法
weixin_30418341的博客
11-05 348
SVNKit(JavaSVN) 是一个纯 Java 的 SVN 客户端库,使用SVNKit无需安装任何 SVN 的客户端,支持各种操作系统。 这不是一个开源的类库,但你可以免费使用. SVNLogClient的方法 doLog() 'svn log' doList() 'svn list' doAnnotate(...
SVN Java 客户端 svnkit 查询两个日期或版本之间的文件差异，类似 svn diff 命令
锄禾日当午，啥都不靠谱；闲来没事做，不如写博客。
09-12 496
【代码】SVN Java 客户端 svnkit 查询两个日期或版本之间的文件差异，类似 svn diff 命令。
php实现svn代码量统计
06-03
您可以使用PHP的SVN库来连接到SVN服务器并获取代码库的统计信息。以下是一个示例代码，可用于获取某个版本号的代码量统计信息： ```php <?php // SVN服务器设置 $svn_server = "svn://svn.example.com/myproject"; $svn_username = "username"; $svn_password = "password"; // 获取SVN库 $svn = svn_connect($svn_server); svn_auth_set_parameter(SVN_AUTH_PARAM_DEFAULT_USERNAME, $svn_username); svn_auth_set_parameter(SVN_AUTH_PARAM_DEFAULT_PASSWORD, $svn_password); // 指定版本号 $revision = 1234; // 统计代码量 $command = "svn diff -r " . ($revision - 1) . ":" . $revision . " " . $svn_server . " --summarize"; $output = shell_exec($command); // 解析输出结果 $lines_added = 0; $lines_deleted = 0; $files_changed = 0; $lines = explode("\n", $output); foreach ($lines as $line) { if (preg_match('/^[ADUMR]\s+(.*)$/', $line, $matches)) { $files_changed++; $file = $matches[1]; if (preg_match('/\.php$/', $file)) { $command = "svn diff -x -w -r " . ($revision - 1) . ":" . $revision . " " . $svn_server . "/" . $file . " | grep -E '^[+|\-]' | wc -l"; $output = trim(shell_exec($command)); $lines_added += (int) $output; $command = "svn diff -x -w -r " . ($revision - 1) . ":" . $revision . " " . $svn_server . "/" . $file . " | grep -E '^\-' | wc -l"; $output = trim(shell_exec($command)); $lines_deleted += (int) $output; } } } // 输出统计信息 echo "Files changed: " . $files_changed . "\n"; echo "Lines added: " . $lines_added . "\n"; echo "Lines deleted: " . $lines_deleted . "\n"; ?> ``` 在以上代码中，首先需要设置SVN服务器的地址、用户名和密码。然后，使用`svn_connect()`函数连接到SVN服务器，并使用`svn_auth_set_parameter()`函数设置用户名和密码。接下来，使用`svn diff`命令获取指定版本号的代码库变更信息，并使用`shell_exec()`函数执行该命令。然后，解析输出结果，统计代码量并输出统计信息。 在解析输出结果时，使用了正则表达式来匹配文件路径和变更类型，并使用`svn diff`命令获取指定文件的代码变更信息。然后，使用`grep`命令和正则表达式来匹配添加和删除的行，并使用`wc -l`命令统计行数。最后，累加添加和删除的行数，并输出统计信息。

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论 1
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值