Java data bindings for the MusicBrainz Database using Hibernate.

• As of now, musicbrainz-data is meant for read-only access to the MusicBrainz Database. Nothing, however, prevents a user from changing entites; any change might be written to the database and might leave it in an inconsistent state afterwards.
• Only a subset of the database schema is implemented. Access is provided to artists, releases, tracks and recordings (and related tables).

    db.musicbrainz.driver.class=org.postgresql.Driver
    db.musicbrainz.url=jdbc:postgresql://localhost:5432/musicbrainz_db
    db.musicbrainz.user=musicbrainz
    db.musicbrainz.password=musicbrainz

(see src/main/config/musicbrainz-data.properties.example for all available options)

    <import resource="spring/musicbrainz-data.xml" />

    <dependency>
      <groupId>fm.last</groupId>
      <artifactId>musicbrainz-data</artifactId>
      <version>3.0.0</version>
    </dependency>

See the included tests for more examples. The Javadoc can be generated by running mvn javadoc:javadoc.

    @Component
    public class ArtistHandler {

      private final ArtistDao artistDao;

      @Autowired
      public ArtistHandler(ArtistDao artistDao) {
        this.artistDao = artistDao;
      }

      @Transactional
      public void process(int id) {
        Artist artist = artistDao.getById(id);
        // ...
      }
    }

    List<Artist> artists = artistDao.getByName("mono");

    UUID musicBrainzId = UUID.fromString("c69b70bc-049e-3e3f-a5e4-5a1b4d62105f");
    Release release = releaseDao.getByGid(musicBrainzId);

• Create an empty database musicbrainz_musicbrainzdata_unittest (as described in the MusicBrainz documentation).
• Run mvn clean verify

All contributions are welcome. Please use the Last.fm codeformatting profile found in the lastfm-oss-config project for formatting your changes.

• Stefan Sperber (Last.fm)
• Oliver Charles (MusicBrainz)
• Aurélien Mino

Copyright 2013 Last.fm

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Last.fm <3 MusicBrainz