{"id":19740260,"url":"https://github.com/nceas/ezid","last_synced_at":"2025-04-30T05:32:49.873Z","repository":{"id":4299992,"uuid":"5431502","full_name":"NCEAS/ezid","owner":"NCEAS","description":"Implementation of the EZID identifier services in a Java library","archived":false,"fork":false,"pushed_at":"2021-06-04T01:13:47.000Z","size":62,"stargazers_count":4,"open_issues_count":7,"forks_count":4,"subscribers_count":13,"default_branch":"main","last_synced_at":"2024-04-17T06:10:46.775Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/NCEAS.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2012-08-15T21:01:52.000Z","updated_at":"2024-04-17T06:10:46.775Z","dependencies_parsed_at":"2022-08-29T21:21:11.595Z","dependency_job_id":null,"html_url":"https://github.com/NCEAS/ezid","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NCEAS%2Fezid","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NCEAS%2Fezid/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NCEAS%2Fezid/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NCEAS%2Fezid/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/NCEAS","download_url":"https://codeload.github.com/NCEAS/ezid/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224199142,"owners_count":17272231,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":"2024-11-12T01:20:15.129Z","updated_at":"2024-11-12T01:20:15.704Z","avatar_url":"https://github.com/NCEAS.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"EZID Service Library\n====================\n\n[EZID](http://ezid.cdlib.org) is a service for creating and managing unique\nidentifiers for use in scholarly publishing that is provided by the California\nDigital Library.  This software library, ezid, provides a Java class that\nencapsulates the EZID service to simplify writing client applications that use\nthe EZID service. ezid provides methods for authenticating against the EZID\nservice and then managing identifiers.  Using the service requires an account\nwith the EZID service.  For more information, see:\n   http://ezid.cdlib.org/doc/apidoc.html\n\nOnce you have added the library to your project classpath (see below), you can generate identifiers with EZID with simple Java calls.  Here's a simple example to mint a new identifier using a DataCite 4.0 compliant metadata file in the current directory:\n\n```java\nimport java.io.IOException;\nimport java.nio.file.Files;\nimport java.nio.file.Paths;\nimport java.util.HashMap;\nimport edu.ucsb.nceas.ezid.EZIDService;\nimport edu.ucsb.nceas.ezid.EZIDException;\n\npublic class EZIDExample {\n    public static void main(String args[]) {\n        try {\n            String USERNAME = \"apitest\";\n            String PASSWORD = \"apitest\";\n            String DOISHOULDER = \"doi:10.5072/FK2\";\n\n            EZIDService ezid = new EZIDService();\n            ezid.login(USERNAME, PASSWORD);\n\n            HashMap\u003cString, String\u003e metadata = new HashMap\u003cString, String\u003e();\n            String xml = new String(Files.readAllBytes((Paths.get(\"datacite.xml\"))));\n            metadata.put(\"datacite\", xml);\n            String testId = ezid.mintIdentifier(DOISHOULDER, metadata);\n            System.out.println(\"Generated: \" + testId);\n        } catch (EZIDException e) {\n            System.err.println(\"Identifier minting failed: \" + e.getMessage());\n        } catch (IOException e) {\n            System.err.println(\"Reading DataCiteXML failed: \" + e.getMessage());\n        }\n    }\n}\n```\n\nSee the javadoc documentation for an overview of usage, as well as the\nEZIDServiceTest.java JUnit class for more examples of usage.\n\nSee the License section below and LICENSE.txt for the details of distributing this software.\n\nContributors\n------------\n* [Matthew B. Jones](http://matt.magisa.org), [NCEAS](http://www.nceas.ucsb.edu)\n* Ben Leinfelder, [NCEAS](http://www.nceas.ucsb.edu)\n\nUsing the library\n-----------------\nTo use the library in your Java application, you can add it to your pom.xml\nconfiguration if you are using Maven.  You can access the ezid jar files through\nMaven by adding the appropriate maven repository to your pom.  Something like\nthis snippet should work:\n\n```xml\n    ...\n    \u003crepositories\u003e\n        \u003crepository\u003e\n            \u003cid\u003edataone.org\u003c/id\u003e\n            \u003curl\u003ehttp://dev-testing.dataone.org/maven\u003c/url\u003e\n            \u003creleases\u003e\n                \u003cenabled\u003etrue\u003c/enabled\u003e\n            \u003c/releases\u003e\n            \u003csnapshots\u003e\n                \u003cenabled\u003etrue\u003c/enabled\u003e\n            \u003c/snapshots\u003e\n        \u003c/repository\u003e\n    \u003c/repositories\u003e\n    \u003cdependencies\u003e\n    \t\u003cdependency\u003e\n    \t\t\u003cgroupId\u003eedu.ucsb.nceas\u003c/groupId\u003e\n\t\t\t\u003cartifactId\u003eezid\u003c/artifactId\u003e\n\t\t\t\u003cversion\u003e1.0.3\u003c/version\u003e\n\t\t\t\u003ctype\u003ejar\u003c/type\u003e\n    \t\u003c/dependency\u003e\n    \u003c/dependencies\u003e\n```\n\nWe plan to publish the ezid artifacts to Maven Central repositories, but have not gotten there yet.\n\nBuilding the library\n--------------------\nThe library is a standard Maven2 project.  To build the library, install Maven2,\nand then run:\n\n  $ mvn package\n\nwhich will create the jar file in the target directory. The jar file can then be\nincluded in applications that wish to access EZID.\n\nContact us: knb-help@nceas.ucsb.edu\n\nContributions\n-------------\nWe welcome contributions to the project, and will incorporate pull requests after code review as long as the code requests are licensed acceptably and provide improvements that would generally be useful to the community of EZID users.  Please submit pull request via GitHub.\n\nIssue Tracking\n--------------\nBugs, new features, and comments on the EZID library are handled through the [ezid issue tracker](https://github.com/mbjones/ezid/issues?state=open \"ezid issues\").  \n\nLicense\n-------\n```\nThis work was created by the National Center for Ecological Analysis and\nSynthesis at the University of California Santa Barbara (UCSB).\n\n  Copyright 2011-2104 Regents of the University of California\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\n  http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnceas%2Fezid","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnceas%2Fezid","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnceas%2Fezid/lists"}