V-Mock

Простая, лёгкая, мгновенно развёртываемая система имитации интерфейса.

V-Mock — что это?

V-Mock — это компактная система имитации отклика интерфейса, которая после установки позволяет ввести имитируемый URL интерфейса и формат возвращаемых данных (JSON, XML или другой), после чего можно начинать вызовы.

Функции

• Поддержка любых типов запросов, включая запросы с параметрами Path.
• Поддержка пользовательских заголовков отклика, кодов состояния HTTP и тела ответа. (Однако не рекомендуется произвольно устанавливать коды HTTP, например, некоторые браузеры могут зависнуть при получении кода 789 в ответе).
• Предоставление подробных журналов для каждого успешного вызова, включая детали запроса и ответа, а также заголовки запросов, параметры, заголовки и файлы cookie.
• Возможность создания различных форматов ответов и быстрого переключения между ними.
• Встроенная база данных SQLite, пользователю не нужно заботиться о базе данных, можно рассматривать её как отсутствие базы данных.

Примечание: на данный момент не поддерживается логическая смена формата ответа в зависимости от параметров запроса, только возможность переключения формата ответа в фоновом режиме, но это удобно для разработчиков и тестировщиков.

В каких случаях вы можете использовать V-Mock?

• Взаимодействие между фронтендом и бэкендом, когда бэкенд ещё не разработан.
• Взаимодействие с третьими сторонами, но они не могут предоставить тестовую среду.
• Требуется функция Mock без «загрязнения» кода.
• Компания требует строгой безопасности данных или невозможно передать данные третьим сторонам/разработка ведётся внутри сети.
• Считаете, что аналогичные высокоуровневые программные функции слишком сложны для использования или трудно развертываются.

Как установить

Если вам нужно только использовать, достаточно JRE, никакого дополнительного программного обеспечения не требуется. Не нужно клонировать исходный код! Просто перейдите на страницу Releases (если доступ медленный, используйте 码云) и загрузите последнюю версию файла jar.

Достаточно одной команды для запуска:

java -jar v-mock.jar

По умолчанию используется порт 80, можно добавить --server.port=xxx, чтобы указать свой порт.

🌟Обратите внимание! Файлы базы данных sqlite по умолчанию находятся в каталоге java.io.tmpdir. По умолчанию это каталог временных файлов системы, если ваше устройство выполняет операции по очистке временных файлов, перед командой -jar можно вставить -Djava.io.tmpdir=xxxxx, чтобы изменить путь к временным файлам этого проекта, чтобы избежать потери данных. В новой версии по умолчанию путь java.io.tmpdir изменён на местоположение текущего файла jar, чтобы предотвратить потерю данных.

Например, запуск на порту 8089:

java -jar v-mock.jar --server.port=8089

Рекомендуется сохранить файл как сценарий sh или bat для удобства последующего использования.

Как использовать

После установки перейдите к интерфейсу V-Mock через ваш IP и указанный порт. Войдите в систему с учётными данными администратора vmock/vmock123.

После успешного входа вы можете настроить необходимые имитируемые URL в модуле «Интерфейс один взгляд».

Обратите внимание

Все имитированные URL принадлежат контекстному пути /vmock по умолчанию. Если вы настроите /v1/test, запрос будет получен по адресу http(s): //ip:prot/vmock/v1/test. То есть, если вызывающая система использует корневой путь в файле конфигурации, необходимо добавить /vmock.

Если вы настроите конфликтующие URL, путь будет иметь самый низкий приоритет. Например, если вы настроили /v1/test/{path} и /v1/test/12, то доступ к /vmock/v1/test/12 приведёт к конфигурации /1/test/12. Доступ к /vmock/v1/test/13 приведёт к конфигурации /v1/test/{path}.

Многопользовательский режим

Администратор также может изменять системные параметры, такие как «пригласительный код», чтобы обычные пользователи могли зарегистрироваться в системе самостоятельно.

Права доступа

Права доступа очень просты:

• Администратор: может просматривать модули «Системные параметры» и «Управление пользователями».
• Обычный пользователь: может использовать модули «Интерфейс один взгляд» и «Журнал интерфейса».
• Без входа: можно вызывать систему, настроенную в /vmock, в соответствии с имитированными URL.