MOJI 开源项目教程

MOJI 开源项目教程

moji MOJI is an unofficial Java client for Moss 项目地址: https://gitcode.com/gh_mirrors/mo/moji

1. 项目介绍

MOJI 是一个非官方的 Java 客户端，用于与 Moss 抄袭检测服务进行交互。它具有以下关键特性：

• 纯 Java 实现，依赖较少
• 跨平台支持
• 需要的 Java 版本：Java 6 或更高
• 需要的库：Apache Commons IO 2.3

MOJI 通过网络套接字与 Moss 服务器通信，允许用户上传学生源代码和基准代码，然后生成一个报告，显示可能的抄袭情况。

2. 项目快速启动

以下步骤将帮助你快速启动 MOJI 项目：

首先，确保你的开发环境已经安装了 Java 6 或更高版本。

安装 MOJI

你可以通过以下两种方式之一获取 MOJI 的二进制文件：

• 将 MOJI 作为 Maven 依赖添加到你的项目中：

<dependency>
    <groupId>it.zielke</groupId>
    <artifactId>moji</artifactId>
    <version>1.0.2</version>
</dependency>

• 下载 JAR 文件并将其包含在你的 Java 项目中。
• 使用 Maven 自行构建 JAR 文件并包含在 Java 项目中。

配置和运行

1. 准备 Moss 兼容的目录结构，以便区分不同的学生。复制所有学生源代码到一个目录，每个子目录包含一个学生的源代码。

solution_directory
├── student1
│   ├── classA.java
│   └── ...
├── student2
│   ├── ...
│   └── ...
└── student3
    ├── ...
    └── ...

2. 创建一个新的 SocketClient 对象以与 Moss 服务器通信。

import java.io.File;
import java.util.Collection;
import java.net.URL;
import org.apache.commons.io.FileUtils;
import it.zielke.moji.SocketClient;

public class QuickStart {
    public static void main(String[] args) throws Exception {
        // 学生源代码文件列表
        Collection<File> files = FileUtils.listFiles(new File("C:\\temp\\solution_directory"), new String[] { "java" }, true);
        // 给定学生的基准代码文件列表
        Collection<File> baseFiles = FileUtils.listFiles(new File("C:\\temp\\base_directory"), new String[] { "java" }, true);
        
        // 获取一个新的 SocketClient 实例
        SocketClient socketClient = new SocketClient();
        
        // 设置你的 Moss 用户 ID
        socketClient.setUserID("123456789");
        // 设置学生源代码的编程语言
        socketClient.setLanguage("java");
        
        // 初始化连接并发送参数
        socketClient.run();
        
        // 上传所有基准文件
        for (File f : baseFiles) {
            socketClient.uploadBaseFile(f);
        }
        
        // 上传所有学生源代码文件
        for (File f : files) {
            socketClient.uploadFile(f);
        }
        
        // 完成上传后，通知服务器检查文件
        socketClient.sendQuery();
        
        // 获取 Moss 结果的 URL 并进行相应处理
        URL results = socketClient.getResultURL();
        System.out.println("结果可在以下地址查看：" + results.toString());
    }
}

3. 应用案例和最佳实践

应用案例

MOJI 可以被大学或教育机构用于检测学生作业中的抄袭行为。例如，教授可以将学生的作业上传到 MOJI，然后比较与其他学生作业的相似度。

最佳实践

• 确保所有学生的代码都遵循相同的命名和目录结构规范。
• 在上传代码前，检查是否有任何非法字符或格式错误。
• 定期更新 MOJI 客户端以兼容 Moss 服务的最新版本。

4. 典型生态项目

目前，没有列出与 MOJI 直接相关的生态项目。然而，MOJI 可以与任何支持 Java 的开发工具和平台集成，例如 IntelliJ IDEA、Eclipse 等。此外，MOJI 的开源特性鼓励社区贡献者开发插件和工具，以扩展其功能和兼容性。

moji MOJI is an unofficial Java client for Moss 项目地址: https://gitcode.com/gh_mirrors/mo/moji