{"id":28501447,"url":"https://github.com/bufbuild/protovalidate-java","last_synced_at":"2026-03-04T13:01:01.766Z","repository":{"id":182847986,"uuid":"669231987","full_name":"bufbuild/protovalidate-java","owner":"bufbuild","description":"Protocol Buffer Validation for Java.","archived":false,"fork":false,"pushed_at":"2026-03-02T15:34:02.000Z","size":9410,"stargazers_count":62,"open_issues_count":5,"forks_count":16,"subscribers_count":9,"default_branch":"main","last_synced_at":"2026-03-02T18:49:47.497Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://protovalidate.com","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bufbuild.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-07-21T17:07:47.000Z","updated_at":"2026-03-02T15:35:17.000Z","dependencies_parsed_at":null,"dependency_job_id":"3ac874f3-9a41-4616-b253-50cdf0826047","html_url":"https://github.com/bufbuild/protovalidate-java","commit_stats":null,"previous_names":["bufbuild/protovalidate-java"],"tags_count":42,"template":false,"template_full_name":null,"purl":"pkg:github/bufbuild/protovalidate-java","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bufbuild%2Fprotovalidate-java","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bufbuild%2Fprotovalidate-java/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bufbuild%2Fprotovalidate-java/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bufbuild%2Fprotovalidate-java/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bufbuild","download_url":"https://codeload.github.com/bufbuild/protovalidate-java/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bufbuild%2Fprotovalidate-java/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30081045,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-04T12:28:08.313Z","status":"ssl_error","status_checked_at":"2026-03-04T12:27:28.210Z","response_time":59,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-06-08T16:06:44.740Z","updated_at":"2026-03-04T13:01:01.712Z","avatar_url":"https://github.com/bufbuild.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![The Buf logo](.github/buf-logo.svg)][buf]\n\n# protovalidate-java\n\n[![CI](https://github.com/bufbuild/protovalidate-java/actions/workflows/ci.yaml/badge.svg)](https://github.com/bufbuild/protovalidate-java/actions/workflows/ci.yaml)\n[![Conformance](https://github.com/bufbuild/protovalidate-java/actions/workflows/conformance.yaml/badge.svg)](https://github.com/bufbuild/protovalidate-java/actions/workflows/conformance.yaml)\n[![BSR](https://img.shields.io/badge/BSR-Module-0C65EC)][buf-mod]\n\n[Protovalidate][protovalidate] is the semantic validation library for Protobuf. It provides standard annotations to validate common rules on messages and fields, as well as the ability to use [CEL][cel] to write custom rules. It's the next generation of [protoc-gen-validate][protoc-gen-validate].\n\nWith Protovalidate, you can annotate your Protobuf messages with both standard and custom validation rules:\n\n```protobuf\nsyntax = \"proto3\";\n\npackage acme.user.v1;\n\nimport \"buf/validate/validate.proto\";\n\nmessage User {\n  string id = 1 [(buf.validate.field).string.uuid = true];\n  uint32 age = 2 [(buf.validate.field).uint32.lte = 150]; // We can only hope.\n  string email = 3 [(buf.validate.field).string.email = true];\n  string first_name = 4 [(buf.validate.field).string.max_len = 64];\n  string last_name = 5 [(buf.validate.field).string.max_len = 64];\n\n  option (buf.validate.message).cel = {\n    id: \"first_name_requires_last_name\"\n    message: \"last_name must be present if first_name is present\"\n    expression: \"!has(this.first_name) || has(this.last_name)\"\n  };\n}\n```\n\nOnce you've added `protovalidate-java` to your project, validation is idiomatic Java:\n\n```java\nValidationResult result = validator.validate(message);\nif (!result.isSuccess()) {\n    // Handle failure.\n}\n```\n\n## Installation\n\n\u003e [!TIP]\n\u003e The easiest way to get started with Protovalidate for RPC APIs are the quickstarts in Buf's documentation. There's one available for [Java and gRPC][grpc-java].\n\n`protovalidate-java` is listed in [Maven Central][maven], which provides installation snippets for Gradle, Maven, and other package managers. In Gradle, it's:\n\n```gradle\ndependencies {\n    implementation 'build.buf:protovalidate:\u003cversion\u003e'\n}\n```\n\n## Documentation\n\nComprehensive documentation for Protovalidate is available at [protovalidate.com][protovalidate].\n\nHighlights for Java developers include:\n\n* The [developer quickstart][quickstart]\n* A comprehensive RPC quickstart for [Java and gRPC][grpc-java]\n* A [migration guide for protoc-gen-validate][migration-guide] users\n\n## Additional languages and repositories\n\nProtovalidate isn't just for Java! You might be interested in sibling repositories for other languages:\n\n- [`protovalidate-go`][pv-go] (Go)\n- [`protovalidate-python`][pv-python] (Python)\n- [`protovalidate-cc`][pv-cc] (C++)\n- [`protovalidate-es`][pv-es] (TypeScript and JavaScript)\n\nAdditionally, [protovalidate's core repository](https://github.com/bufbuild/protovalidate) provides:\n\n- [Protovalidate's Protobuf API][validate-proto]\n- [Conformance testing utilities][conformance] for acceptance testing of `protovalidate` implementations\n\n\n## Contributing\n\nWe genuinely appreciate any help! If you'd like to contribute, check out these resources:\n\n- [Contributing Guidelines][contributing]: Guidelines to make your contribution process straightforward and meaningful\n- [Conformance testing utilities](https://github.com/bufbuild/protovalidate/tree/main/docs/conformance.md): Utilities providing acceptance testing of `protovalidate` implementations\n\n## Legal\n\nOffered under the [Apache 2 license][license].\n\n[buf]: https://buf.build\n[cel]: https://cel.dev\n\n[pv-go]: https://github.com/bufbuild/protovalidate-go\n[pv-java]: https://github.com/bufbuild/protovalidate-java\n[pv-python]: https://github.com/bufbuild/protovalidate-python\n[pv-cc]: https://github.com/bufbuild/protovalidate-cc\n[pv-es]: https://github.com/bufbuild/protovalidate-es\n\n[license]: LICENSE\n[contributing]: .github/CONTRIBUTING.md\n[buf-mod]: https://buf.build/bufbuild/protovalidate\n\n[protoc-gen-validate]: https://github.com/bufbuild/protoc-gen-validate\n\n[protovalidate]: https://protovalidate.com\n[quickstart]: https://protovalidate.com/quickstart/\n[connect-go]: https://protovalidate.com/quickstart/connect-go/\n[grpc-go]: https://protovalidate.com/quickstart/grpc-go/\n[grpc-java]: https://protovalidate.com/quickstart/grpc-java/\n[grpc-python]: https://protovalidate.com/quickstart/grpc-python/\n[migration-guide]: https://protovalidate.com/migration-guides/migrate-from-protoc-gen-validate/\n\n[maven]: https://central.sonatype.com/artifact/build.buf/protovalidate/overview\n[pkg-go]: https://pkg.go.dev/github.com/bufbuild/protovalidate-go\n\n[validate-proto]: https://buf.build/bufbuild/protovalidate/docs/main:buf.validate\n[conformance]: https://github.com/bufbuild/protovalidate/blob/main/docs/conformance.md\n[examples]: https://github.com/bufbuild/protovalidate/tree/main/examples\n[migrate]: https://protovalidate.com/migration-guides/migrate-from-protoc-gen-validate/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbufbuild%2Fprotovalidate-java","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbufbuild%2Fprotovalidate-java","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbufbuild%2Fprotovalidate-java/lists"}